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.
- robert_github_agent-0.1.0b1/.github/CODEOWNERS +1 -0
- robert_github_agent-0.1.0b1/.github/ISSUE_TEMPLATE/bug.yml +52 -0
- robert_github_agent-0.1.0b1/.github/ISSUE_TEMPLATE/config.yml +8 -0
- robert_github_agent-0.1.0b1/.github/ISSUE_TEMPLATE/documentation.yml +54 -0
- robert_github_agent-0.1.0b1/.github/ISSUE_TEMPLATE/feature.yml +48 -0
- robert_github_agent-0.1.0b1/.github/PULL_REQUEST_TEMPLATE.md +22 -0
- robert_github_agent-0.1.0b1/.github/dependabot.yml +10 -0
- robert_github_agent-0.1.0b1/.github/workflows/ci.yml +76 -0
- robert_github_agent-0.1.0b1/.github/workflows/dco.yml +53 -0
- robert_github_agent-0.1.0b1/.github/workflows/release.yml +34 -0
- robert_github_agent-0.1.0b1/.gitignore +16 -0
- robert_github_agent-0.1.0b1/AGENTS.md +24 -0
- robert_github_agent-0.1.0b1/CHANGELOG.md +9 -0
- robert_github_agent-0.1.0b1/COMMUNITY.md +141 -0
- robert_github_agent-0.1.0b1/LICENSE +201 -0
- robert_github_agent-0.1.0b1/PKG-INFO +217 -0
- robert_github_agent-0.1.0b1/README.md +183 -0
- robert_github_agent-0.1.0b1/README_ZH.md +171 -0
- robert_github_agent-0.1.0b1/docs/concepts.md +128 -0
- robert_github_agent-0.1.0b1/docs/development.md +430 -0
- robert_github_agent-0.1.0b1/docs/guides.md +200 -0
- robert_github_agent-0.1.0b1/docs/reference.md +145 -0
- robert_github_agent-0.1.0b1/pyproject.toml +49 -0
- robert_github_agent-0.1.0b1/src/robert_agent/__init__.py +1 -0
- robert_github_agent-0.1.0b1/src/robert_agent/acceptance.py +394 -0
- robert_github_agent-0.1.0b1/src/robert_agent/acceptance_suite.py +287 -0
- robert_github_agent-0.1.0b1/src/robert_agent/audit_result.py +501 -0
- robert_github_agent-0.1.0b1/src/robert_agent/authorize.py +117 -0
- robert_github_agent-0.1.0b1/src/robert_agent/board.py +538 -0
- robert_github_agent-0.1.0b1/src/robert_agent/chat_status.py +338 -0
- robert_github_agent-0.1.0b1/src/robert_agent/cli/__init__.py +1 -0
- robert_github_agent-0.1.0b1/src/robert_agent/cli/exit_codes.py +5 -0
- robert_github_agent-0.1.0b1/src/robert_agent/cli/main.py +535 -0
- robert_github_agent-0.1.0b1/src/robert_agent/cli/output.py +20 -0
- robert_github_agent-0.1.0b1/src/robert_agent/common.py +6 -0
- robert_github_agent-0.1.0b1/src/robert_agent/controlled_e2e_acceptance.py +394 -0
- robert_github_agent-0.1.0b1/src/robert_agent/daemon.py +607 -0
- robert_github_agent-0.1.0b1/src/robert_agent/daemon_state.py +319 -0
- robert_github_agent-0.1.0b1/src/robert_agent/diagnostics.py +119 -0
- robert_github_agent-0.1.0b1/src/robert_agent/discover.py +775 -0
- robert_github_agent-0.1.0b1/src/robert_agent/dispatch.py +217 -0
- robert_github_agent-0.1.0b1/src/robert_agent/doctor.py +94 -0
- robert_github_agent-0.1.0b1/src/robert_agent/github_api.py +12 -0
- robert_github_agent-0.1.0b1/src/robert_agent/init_config.py +126 -0
- robert_github_agent-0.1.0b1/src/robert_agent/integrations/__init__.py +1 -0
- robert_github_agent-0.1.0b1/src/robert_agent/integrations/openclaw.py +285 -0
- robert_github_agent-0.1.0b1/src/robert_agent/live_discovery_acceptance.py +70 -0
- robert_github_agent-0.1.0b1/src/robert_agent/live_worker_acceptance.py +363 -0
- robert_github_agent-0.1.0b1/src/robert_agent/live_worktree_acceptance.py +344 -0
- robert_github_agent-0.1.0b1/src/robert_agent/loop_engine.py +285 -0
- robert_github_agent-0.1.0b1/src/robert_agent/memory_curator.py +105 -0
- robert_github_agent-0.1.0b1/src/robert_agent/migrate.py +157 -0
- robert_github_agent-0.1.0b1/src/robert_agent/notify.py +74 -0
- robert_github_agent-0.1.0b1/src/robert_agent/paths.py +16 -0
- robert_github_agent-0.1.0b1/src/robert_agent/production_write_canary.py +254 -0
- robert_github_agent-0.1.0b1/src/robert_agent/project_memory.py +503 -0
- robert_github_agent-0.1.0b1/src/robert_agent/publish.py +743 -0
- robert_github_agent-0.1.0b1/src/robert_agent/publish_dedupe_acceptance.py +270 -0
- robert_github_agent-0.1.0b1/src/robert_agent/redaction.py +41 -0
- robert_github_agent-0.1.0b1/src/robert_agent/render_prompt.py +544 -0
- robert_github_agent-0.1.0b1/src/robert_agent/resource_files.py +8 -0
- robert_github_agent-0.1.0b1/src/robert_agent/resources/__init__.py +1 -0
- robert_github_agent-0.1.0b1/src/robert_agent/resources/acceptance-matrix.md +120 -0
- robert_github_agent-0.1.0b1/src/robert_agent/resources/classifier.md +19 -0
- robert_github_agent-0.1.0b1/src/robert_agent/resources/command-matrix.md +38 -0
- robert_github_agent-0.1.0b1/src/robert_agent/resources/config.example.yml +20 -0
- robert_github_agent-0.1.0b1/src/robert_agent/resources/db/migrations/001_legacy_dd_to_robert.sql +14 -0
- robert_github_agent-0.1.0b1/src/robert_agent/resources/db/schema.sql +479 -0
- robert_github_agent-0.1.0b1/src/robert_agent/resources/failure-modes.md +36 -0
- robert_github_agent-0.1.0b1/src/robert_agent/resources/fixtures/actor-permission.json +1 -0
- robert_github_agent-0.1.0b1/src/robert_agent/resources/fixtures/discovery.json +1 -0
- robert_github_agent-0.1.0b1/src/robert_agent/resources/fixtures/redaction.json +1 -0
- robert_github_agent-0.1.0b1/src/robert_agent/resources/fixtures/review-followup.json +1 -0
- robert_github_agent-0.1.0b1/src/robert_agent/resources/fixtures/worker-results.json +1 -0
- robert_github_agent-0.1.0b1/src/robert_agent/resources/fixtures/workstreams.json +1 -0
- robert_github_agent-0.1.0b1/src/robert_agent/resources/github-events.md +77 -0
- robert_github_agent-0.1.0b1/src/robert_agent/resources/kanban-control.md +165 -0
- robert_github_agent-0.1.0b1/src/robert_agent/resources/redaction.md +29 -0
- robert_github_agent-0.1.0b1/src/robert_agent/resources/result-contract.md +56 -0
- robert_github_agent-0.1.0b1/src/robert_agent/resources/routes.yml +82 -0
- robert_github_agent-0.1.0b1/src/robert_agent/resources/schemas/config.schema.json +123 -0
- robert_github_agent-0.1.0b1/src/robert_agent/resources/schemas/event.schema.json +18 -0
- robert_github_agent-0.1.0b1/src/robert_agent/resources/schemas/result.schema.json +99 -0
- robert_github_agent-0.1.0b1/src/robert_agent/resources/schemas/route.schema.json +23 -0
- robert_github_agent-0.1.0b1/src/robert_agent/resources/schemas/snapshot.schema.json +17 -0
- robert_github_agent-0.1.0b1/src/robert_agent/resources/schemas/task.schema.json +15 -0
- robert_github_agent-0.1.0b1/src/robert_agent/resources/trust-model.md +16 -0
- robert_github_agent-0.1.0b1/src/robert_agent/resources/worker-prompt.md +121 -0
- robert_github_agent-0.1.0b1/src/robert_agent/resources/worker-protocol.md +47 -0
- robert_github_agent-0.1.0b1/src/robert_agent/resources/workflow.yml +50 -0
- robert_github_agent-0.1.0b1/src/robert_agent/resources/workstream-model.md +17 -0
- robert_github_agent-0.1.0b1/src/robert_agent/route.py +232 -0
- robert_github_agent-0.1.0b1/src/robert_agent/route_config.py +64 -0
- robert_github_agent-0.1.0b1/src/robert_agent/run_once.py +5375 -0
- robert_github_agent-0.1.0b1/src/robert_agent/runtime_knowledge.py +392 -0
- robert_github_agent-0.1.0b1/src/robert_agent/service.py +161 -0
- robert_github_agent-0.1.0b1/src/robert_agent/skills.py +28 -0
- robert_github_agent-0.1.0b1/src/robert_agent/status.py +1051 -0
- robert_github_agent-0.1.0b1/src/robert_agent/storage.py +376 -0
- robert_github_agent-0.1.0b1/src/robert_agent/summarize.py +100 -0
- robert_github_agent-0.1.0b1/src/robert_agent/supervise.py +72 -0
- robert_github_agent-0.1.0b1/src/robert_agent/usage.py +192 -0
- robert_github_agent-0.1.0b1/src/robert_agent/validate_config.py +616 -0
- robert_github_agent-0.1.0b1/src/robert_agent/wakeup.py +261 -0
- robert_github_agent-0.1.0b1/src/robert_agent/web.py +2893 -0
- robert_github_agent-0.1.0b1/src/robert_agent/web_assets/board.css +255 -0
- robert_github_agent-0.1.0b1/src/robert_agent/web_assets/board.html +165 -0
- robert_github_agent-0.1.0b1/src/robert_agent/web_assets/board.js +660 -0
- robert_github_agent-0.1.0b1/src/robert_agent/web_assets/github-shell.css +122 -0
- robert_github_agent-0.1.0b1/src/robert_agent/web_assets/index.html +103 -0
- robert_github_agent-0.1.0b1/src/robert_agent/web_assets/operations.css +168 -0
- robert_github_agent-0.1.0b1/src/robert_agent/web_assets/workbench.css +131 -0
- robert_github_agent-0.1.0b1/src/robert_agent/web_assets/workbench.js +581 -0
- robert_github_agent-0.1.0b1/src/robert_agent/work_items.py +1016 -0
- robert_github_agent-0.1.0b1/src/robert_agent/workbench.py +701 -0
- robert_github_agent-0.1.0b1/src/robert_agent/worker/__init__.py +1 -0
- robert_github_agent-0.1.0b1/src/robert_agent/worker/heartbeat.py +190 -0
- robert_github_agent-0.1.0b1/src/robert_agent/worker/result.py +321 -0
- robert_github_agent-0.1.0b1/src/robert_agent/worker/snapshot.py +98 -0
- robert_github_agent-0.1.0b1/src/robert_agent/worker_adapters/__init__.py +138 -0
- robert_github_agent-0.1.0b1/src/robert_agent/worker_adapters/cbc.py +68 -0
- robert_github_agent-0.1.0b1/src/robert_agent/worker_adapters/codex.py +56 -0
- robert_github_agent-0.1.0b1/src/robert_agent/worker_adapters/command.py +33 -0
- robert_github_agent-0.1.0b1/src/robert_agent/worker_adapters/tcodex.py +56 -0
- robert_github_agent-0.1.0b1/src/robert_agent/worker_heartbeat.py +6 -0
- robert_github_agent-0.1.0b1/src/robert_agent/worker_result.py +6 -0
- robert_github_agent-0.1.0b1/src/robert_agent/worker_snapshot.py +6 -0
- robert_github_agent-0.1.0b1/src/robert_agent/workstream.py +55 -0
- robert_github_agent-0.1.0b1/src/robert_agent/worktree.py +297 -0
- robert_github_agent-0.1.0b1/tests/__init__.py +1 -0
- robert_github_agent-0.1.0b1/tests/support.py +22 -0
- robert_github_agent-0.1.0b1/tests/test_acceptance_suite.py +170 -0
- robert_github_agent-0.1.0b1/tests/test_board.py +258 -0
- robert_github_agent-0.1.0b1/tests/test_board_control_integration.py +363 -0
- robert_github_agent-0.1.0b1/tests/test_cli.py +125 -0
- robert_github_agent-0.1.0b1/tests/test_config_and_schema.py +1022 -0
- robert_github_agent-0.1.0b1/tests/test_controlled_e2e_acceptance.py +72 -0
- robert_github_agent-0.1.0b1/tests/test_daemon.py +1054 -0
- robert_github_agent-0.1.0b1/tests/test_diagnostics.py +26 -0
- robert_github_agent-0.1.0b1/tests/test_discovery_authorization.py +1334 -0
- robert_github_agent-0.1.0b1/tests/test_distribution.py +36 -0
- robert_github_agent-0.1.0b1/tests/test_docs.py +43 -0
- robert_github_agent-0.1.0b1/tests/test_github_event_matrix.py +393 -0
- robert_github_agent-0.1.0b1/tests/test_init_and_doctor.py +64 -0
- robert_github_agent-0.1.0b1/tests/test_live_discovery_acceptance.py +94 -0
- robert_github_agent-0.1.0b1/tests/test_live_worker_acceptance.py +174 -0
- robert_github_agent-0.1.0b1/tests/test_live_worktree_acceptance.py +69 -0
- robert_github_agent-0.1.0b1/tests/test_loop_engine.py +316 -0
- robert_github_agent-0.1.0b1/tests/test_migration.py +98 -0
- robert_github_agent-0.1.0b1/tests/test_openclaw.py +19 -0
- robert_github_agent-0.1.0b1/tests/test_operational_commands.py +5506 -0
- robert_github_agent-0.1.0b1/tests/test_package_layout.py +27 -0
- robert_github_agent-0.1.0b1/tests/test_paths.py +32 -0
- robert_github_agent-0.1.0b1/tests/test_production_write_canary.py +142 -0
- robert_github_agent-0.1.0b1/tests/test_project_memory.py +286 -0
- robert_github_agent-0.1.0b1/tests/test_public_surface.py +66 -0
- robert_github_agent-0.1.0b1/tests/test_publish_dedupe_acceptance.py +37 -0
- robert_github_agent-0.1.0b1/tests/test_redaction.py +89 -0
- robert_github_agent-0.1.0b1/tests/test_route_config.py +126 -0
- robert_github_agent-0.1.0b1/tests/test_routing.py +330 -0
- robert_github_agent-0.1.0b1/tests/test_run_once.py +7099 -0
- robert_github_agent-0.1.0b1/tests/test_runtime_knowledge.py +211 -0
- robert_github_agent-0.1.0b1/tests/test_service.py +29 -0
- robert_github_agent-0.1.0b1/tests/test_skills.py +26 -0
- robert_github_agent-0.1.0b1/tests/test_web_security.py +91 -0
- robert_github_agent-0.1.0b1/tests/test_work_items.py +704 -0
- robert_github_agent-0.1.0b1/tests/test_workbench.py +333 -0
- robert_github_agent-0.1.0b1/tests/test_worker_adapter_config.py +48 -0
- robert_github_agent-0.1.0b1/tests/test_worker_protocol.py +1885 -0
- robert_github_agent-0.1.0b1/tests/test_workflow_matrix.py +846 -0
- robert_github_agent-0.1.0b1/tests/test_workspace_resolution.py +155 -0
- 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,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,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.
|