robert-github-agent 0.1.0b1__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (111) hide show
  1. robert_agent/__init__.py +1 -0
  2. robert_agent/acceptance.py +394 -0
  3. robert_agent/acceptance_suite.py +287 -0
  4. robert_agent/audit_result.py +501 -0
  5. robert_agent/authorize.py +117 -0
  6. robert_agent/board.py +538 -0
  7. robert_agent/chat_status.py +338 -0
  8. robert_agent/cli/__init__.py +1 -0
  9. robert_agent/cli/exit_codes.py +5 -0
  10. robert_agent/cli/main.py +535 -0
  11. robert_agent/cli/output.py +20 -0
  12. robert_agent/common.py +6 -0
  13. robert_agent/controlled_e2e_acceptance.py +394 -0
  14. robert_agent/daemon.py +607 -0
  15. robert_agent/daemon_state.py +319 -0
  16. robert_agent/diagnostics.py +119 -0
  17. robert_agent/discover.py +775 -0
  18. robert_agent/dispatch.py +217 -0
  19. robert_agent/doctor.py +94 -0
  20. robert_agent/github_api.py +12 -0
  21. robert_agent/init_config.py +126 -0
  22. robert_agent/integrations/__init__.py +1 -0
  23. robert_agent/integrations/openclaw.py +285 -0
  24. robert_agent/live_discovery_acceptance.py +70 -0
  25. robert_agent/live_worker_acceptance.py +363 -0
  26. robert_agent/live_worktree_acceptance.py +344 -0
  27. robert_agent/loop_engine.py +285 -0
  28. robert_agent/memory_curator.py +105 -0
  29. robert_agent/migrate.py +157 -0
  30. robert_agent/notify.py +74 -0
  31. robert_agent/paths.py +16 -0
  32. robert_agent/production_write_canary.py +254 -0
  33. robert_agent/project_memory.py +503 -0
  34. robert_agent/publish.py +743 -0
  35. robert_agent/publish_dedupe_acceptance.py +270 -0
  36. robert_agent/redaction.py +41 -0
  37. robert_agent/render_prompt.py +544 -0
  38. robert_agent/resource_files.py +8 -0
  39. robert_agent/resources/__init__.py +1 -0
  40. robert_agent/resources/acceptance-matrix.md +120 -0
  41. robert_agent/resources/classifier.md +19 -0
  42. robert_agent/resources/command-matrix.md +38 -0
  43. robert_agent/resources/config.example.yml +20 -0
  44. robert_agent/resources/db/migrations/001_legacy_dd_to_robert.sql +14 -0
  45. robert_agent/resources/db/schema.sql +479 -0
  46. robert_agent/resources/failure-modes.md +36 -0
  47. robert_agent/resources/fixtures/actor-permission.json +1 -0
  48. robert_agent/resources/fixtures/discovery.json +1 -0
  49. robert_agent/resources/fixtures/redaction.json +1 -0
  50. robert_agent/resources/fixtures/review-followup.json +1 -0
  51. robert_agent/resources/fixtures/worker-results.json +1 -0
  52. robert_agent/resources/fixtures/workstreams.json +1 -0
  53. robert_agent/resources/github-events.md +77 -0
  54. robert_agent/resources/kanban-control.md +165 -0
  55. robert_agent/resources/redaction.md +29 -0
  56. robert_agent/resources/result-contract.md +56 -0
  57. robert_agent/resources/routes.yml +82 -0
  58. robert_agent/resources/schemas/config.schema.json +123 -0
  59. robert_agent/resources/schemas/event.schema.json +18 -0
  60. robert_agent/resources/schemas/result.schema.json +99 -0
  61. robert_agent/resources/schemas/route.schema.json +23 -0
  62. robert_agent/resources/schemas/snapshot.schema.json +17 -0
  63. robert_agent/resources/schemas/task.schema.json +15 -0
  64. robert_agent/resources/trust-model.md +16 -0
  65. robert_agent/resources/worker-prompt.md +121 -0
  66. robert_agent/resources/worker-protocol.md +47 -0
  67. robert_agent/resources/workflow.yml +50 -0
  68. robert_agent/resources/workstream-model.md +17 -0
  69. robert_agent/route.py +232 -0
  70. robert_agent/route_config.py +64 -0
  71. robert_agent/run_once.py +5375 -0
  72. robert_agent/runtime_knowledge.py +392 -0
  73. robert_agent/service.py +161 -0
  74. robert_agent/skills.py +28 -0
  75. robert_agent/status.py +1051 -0
  76. robert_agent/storage.py +376 -0
  77. robert_agent/summarize.py +100 -0
  78. robert_agent/supervise.py +72 -0
  79. robert_agent/usage.py +192 -0
  80. robert_agent/validate_config.py +616 -0
  81. robert_agent/wakeup.py +261 -0
  82. robert_agent/web.py +2893 -0
  83. robert_agent/web_assets/board.css +255 -0
  84. robert_agent/web_assets/board.html +165 -0
  85. robert_agent/web_assets/board.js +660 -0
  86. robert_agent/web_assets/github-shell.css +122 -0
  87. robert_agent/web_assets/index.html +103 -0
  88. robert_agent/web_assets/operations.css +168 -0
  89. robert_agent/web_assets/workbench.css +131 -0
  90. robert_agent/web_assets/workbench.js +581 -0
  91. robert_agent/work_items.py +1016 -0
  92. robert_agent/workbench.py +701 -0
  93. robert_agent/worker/__init__.py +1 -0
  94. robert_agent/worker/heartbeat.py +190 -0
  95. robert_agent/worker/result.py +321 -0
  96. robert_agent/worker/snapshot.py +98 -0
  97. robert_agent/worker_adapters/__init__.py +138 -0
  98. robert_agent/worker_adapters/cbc.py +68 -0
  99. robert_agent/worker_adapters/codex.py +56 -0
  100. robert_agent/worker_adapters/command.py +33 -0
  101. robert_agent/worker_adapters/tcodex.py +56 -0
  102. robert_agent/worker_heartbeat.py +6 -0
  103. robert_agent/worker_result.py +6 -0
  104. robert_agent/worker_snapshot.py +6 -0
  105. robert_agent/workstream.py +55 -0
  106. robert_agent/worktree.py +297 -0
  107. robert_github_agent-0.1.0b1.dist-info/METADATA +217 -0
  108. robert_github_agent-0.1.0b1.dist-info/RECORD +111 -0
  109. robert_github_agent-0.1.0b1.dist-info/WHEEL +4 -0
  110. robert_github_agent-0.1.0b1.dist-info/entry_points.txt +2 -0
  111. robert_github_agent-0.1.0b1.dist-info/licenses/LICENSE +201 -0
@@ -0,0 +1,297 @@
1
+ #!/usr/bin/env python3
2
+ import argparse
3
+ import re
4
+ import shlex
5
+ import subprocess
6
+ from pathlib import Path
7
+
8
+ from robert_agent.common import emit
9
+
10
+
11
+ def _slug(value):
12
+ normalized = re.sub(r"[^A-Za-z0-9._-]+", "-", value.strip().lower()).strip("-")
13
+ return normalized or "task"
14
+
15
+
16
+ def _existing_worktree_for_branch(repo_root, branch_name):
17
+ try:
18
+ completed = subprocess.run(
19
+ ["git", "worktree", "list", "--porcelain"],
20
+ cwd=repo_root,
21
+ text=True,
22
+ capture_output=True,
23
+ check=True,
24
+ )
25
+ except (subprocess.CalledProcessError, FileNotFoundError):
26
+ return None
27
+
28
+ worktree_path = None
29
+ prefix = "branch refs/heads/"
30
+ for line in completed.stdout.splitlines():
31
+ if line.startswith("worktree "):
32
+ worktree_path = Path(line.split(" ", 1)[1])
33
+ continue
34
+ if worktree_path and line.startswith(prefix) and line[len(prefix) :] == branch_name:
35
+ return worktree_path
36
+ if not line:
37
+ worktree_path = None
38
+ return None
39
+
40
+
41
+ def plan_worktree(
42
+ repo_root,
43
+ worktree_root,
44
+ source_number,
45
+ short_slug,
46
+ base_branch,
47
+ existing_pr_head_branch=None,
48
+ dry_run=True,
49
+ ):
50
+ repo_root = Path(repo_root)
51
+ worktree_root = Path(worktree_root)
52
+ if existing_pr_head_branch:
53
+ branch_name = existing_pr_head_branch
54
+ else:
55
+ branch_name = f"codex/dd-{source_number}-{_slug(short_slug)}"
56
+
57
+ existing_worktree_path = _existing_worktree_for_branch(repo_root, branch_name)
58
+ if existing_worktree_path:
59
+ mode = "reuse_existing_worktree"
60
+ elif existing_pr_head_branch:
61
+ mode = "reuse_existing_pr"
62
+ else:
63
+ mode = "new_branch"
64
+
65
+ worktree_path = existing_worktree_path or (worktree_root / branch_name.replace("/", "__"))
66
+ start_point = f"upstream/{base_branch}"
67
+ commands = []
68
+ if mode == "new_branch":
69
+ commands.append(f"git fetch upstream {base_branch}")
70
+ commands.append(f"git worktree add {worktree_path} -b {branch_name} {start_point}")
71
+ elif mode == "reuse_existing_worktree":
72
+ commands.append(f"reuse existing worktree {worktree_path}")
73
+ else:
74
+ commands.append(f"git worktree add {worktree_path} {branch_name}")
75
+
76
+ result = {
77
+ "ok": True,
78
+ "status": "planned" if dry_run else "created",
79
+ "mode": mode,
80
+ "repo_root": str(repo_root),
81
+ "worktree_root": str(worktree_root),
82
+ "worktree_path": str(worktree_path),
83
+ "branch_name": branch_name,
84
+ "base_branch": base_branch,
85
+ "start_point": start_point,
86
+ "commands": commands,
87
+ }
88
+ if dry_run:
89
+ return result
90
+
91
+ if mode == "reuse_existing_worktree":
92
+ return result
93
+
94
+ worktree_root.mkdir(parents=True, exist_ok=True)
95
+ if mode == "new_branch":
96
+ subprocess.run(["git", "fetch", "upstream", base_branch], cwd=repo_root, check=True)
97
+ subprocess.run(
98
+ ["git", "worktree", "add", str(worktree_path), "-b", branch_name, start_point],
99
+ cwd=repo_root,
100
+ check=True,
101
+ )
102
+ else:
103
+ subprocess.run(
104
+ ["git", "worktree", "add", str(worktree_path), branch_name],
105
+ cwd=repo_root,
106
+ check=True,
107
+ )
108
+ return result
109
+
110
+
111
+ def plan_review_worktree(
112
+ repo_root,
113
+ worktree_root,
114
+ source_number,
115
+ short_slug,
116
+ base_branch,
117
+ dry_run=True,
118
+ ):
119
+ repo_root = Path(repo_root)
120
+ worktree_root = Path(worktree_root)
121
+ branch_name = f"review/pr-{source_number}-{_slug(short_slug)}"
122
+ existing_worktree_path = _existing_worktree_for_branch(repo_root, branch_name)
123
+ mode = "reuse_existing_worktree" if existing_worktree_path else "review_pr"
124
+ worktree_path = existing_worktree_path or (worktree_root / branch_name.replace("/", "__"))
125
+ start_point = f"upstream/{base_branch}"
126
+ commands = []
127
+ if mode == "reuse_existing_worktree":
128
+ commands.append(f"reuse existing worktree {worktree_path}")
129
+ else:
130
+ commands.append(f"git fetch upstream {base_branch}")
131
+ commands.append(f"git fetch upstream pull/{source_number}/head:{branch_name}")
132
+ commands.append(f"git worktree add {worktree_path} {branch_name}")
133
+
134
+ result = {
135
+ "ok": True,
136
+ "status": "planned" if dry_run else "created",
137
+ "mode": mode,
138
+ "repo_root": str(repo_root),
139
+ "worktree_root": str(worktree_root),
140
+ "worktree_path": str(worktree_path),
141
+ "branch_name": branch_name,
142
+ "base_branch": base_branch,
143
+ "start_point": start_point,
144
+ "commands": commands,
145
+ }
146
+ if dry_run or mode == "reuse_existing_worktree":
147
+ return result
148
+
149
+ worktree_root.mkdir(parents=True, exist_ok=True)
150
+ subprocess.run(["git", "fetch", "upstream", base_branch], cwd=repo_root, check=True)
151
+ subprocess.run(
152
+ ["git", "fetch", "upstream", f"pull/{source_number}/head:{branch_name}"],
153
+ cwd=repo_root,
154
+ check=True,
155
+ )
156
+ subprocess.run(
157
+ ["git", "worktree", "add", str(worktree_path), branch_name],
158
+ cwd=repo_root,
159
+ check=True,
160
+ )
161
+ return result
162
+
163
+
164
+ def _registered_worktree(repo_root, expected_path):
165
+ try:
166
+ completed = subprocess.run(
167
+ ["git", "worktree", "list", "--porcelain"],
168
+ cwd=repo_root,
169
+ text=True,
170
+ capture_output=True,
171
+ check=True,
172
+ )
173
+ except (subprocess.CalledProcessError, FileNotFoundError):
174
+ return False
175
+ expected_path = Path(expected_path).resolve()
176
+ return any(
177
+ line.startswith("worktree ")
178
+ and Path(line.split(" ", 1)[1]).resolve() == expected_path
179
+ for line in completed.stdout.splitlines()
180
+ )
181
+
182
+
183
+ def plan_analysis_worktree(
184
+ repo_root,
185
+ worktree_root,
186
+ source_number,
187
+ base_branch,
188
+ dry_run=True,
189
+ ):
190
+ repo_root = Path(repo_root)
191
+ worktree_root = Path(worktree_root)
192
+ worktree_path = worktree_root / f"analysis-{source_number}"
193
+ commands = [
194
+ ["git", "fetch", "upstream", base_branch],
195
+ [
196
+ "git",
197
+ "worktree",
198
+ "add",
199
+ "--detach",
200
+ str(worktree_path),
201
+ f"upstream/{base_branch}",
202
+ ],
203
+ ]
204
+ reused = _registered_worktree(repo_root, worktree_path)
205
+ if not dry_run and not reused:
206
+ worktree_root.mkdir(parents=True, exist_ok=True)
207
+ for command in commands:
208
+ subprocess.run(command, cwd=repo_root, check=True)
209
+ return {
210
+ "ok": True,
211
+ "status": (
212
+ "reused"
213
+ if reused
214
+ else ("planned" if dry_run else "prepared")
215
+ ),
216
+ "mode": "analysis",
217
+ "worktree_path": str(worktree_path),
218
+ "branch_name": None,
219
+ "commands": [
220
+ " ".join(shlex.quote(part) for part in command)
221
+ for command in commands
222
+ ],
223
+ }
224
+
225
+
226
+ def resolve_task_workspace(repo, route, source, dry_run):
227
+ mode = route["workspace_mode"]
228
+ if mode == "none":
229
+ return {
230
+ "ok": True,
231
+ "mode": "none",
232
+ "worktree_path": source["artifact_dir"],
233
+ "branch_name": None,
234
+ }
235
+ if mode == "new_branch":
236
+ return plan_worktree(
237
+ repo_root=repo["repo_root"],
238
+ worktree_root=repo["worktree_root"],
239
+ source_number=source["number"],
240
+ short_slug=source["branch_slug"],
241
+ base_branch=repo["default_base_branch"],
242
+ dry_run=dry_run,
243
+ )
244
+ if mode == "existing_pr":
245
+ return plan_worktree(
246
+ repo_root=repo["repo_root"],
247
+ worktree_root=repo["worktree_root"],
248
+ source_number=source["number"],
249
+ short_slug=source["branch_slug"],
250
+ base_branch=repo["default_base_branch"],
251
+ existing_pr_head_branch=source["head_branch"],
252
+ dry_run=dry_run,
253
+ )
254
+ if mode == "review_pr":
255
+ return plan_review_worktree(
256
+ repo_root=repo["repo_root"],
257
+ worktree_root=repo["worktree_root"],
258
+ source_number=source["number"],
259
+ short_slug=source["branch_slug"],
260
+ base_branch=repo["default_base_branch"],
261
+ dry_run=dry_run,
262
+ )
263
+ if mode == "analysis":
264
+ return plan_analysis_worktree(
265
+ repo_root=repo["repo_root"],
266
+ worktree_root=repo["worktree_root"],
267
+ source_number=source["number"],
268
+ base_branch=repo["default_base_branch"],
269
+ dry_run=dry_run,
270
+ )
271
+ raise ValueError(f"unsupported workspace_mode: {mode}")
272
+
273
+
274
+ def main(argv=None):
275
+ parser = argparse.ArgumentParser()
276
+ parser.add_argument("--repo-root", required=True)
277
+ parser.add_argument("--worktree-root", required=True)
278
+ parser.add_argument("--source-number", required=True, type=int)
279
+ parser.add_argument("--short-slug", required=True)
280
+ parser.add_argument("--base-branch", required=True)
281
+ parser.add_argument("--existing-pr-head-branch")
282
+ parser.add_argument("--dry-run", action="store_true")
283
+ args = parser.parse_args(argv)
284
+ result = plan_worktree(
285
+ repo_root=args.repo_root,
286
+ worktree_root=args.worktree_root,
287
+ source_number=args.source_number,
288
+ short_slug=args.short_slug,
289
+ base_branch=args.base_branch,
290
+ existing_pr_head_branch=args.existing_pr_head_branch,
291
+ dry_run=args.dry_run,
292
+ )
293
+ return emit(result)
294
+
295
+
296
+ if __name__ == "__main__":
297
+ raise SystemExit(main())
@@ -0,0 +1,217 @@
1
+ Metadata-Version: 2.4
2
+ Name: robert-github-agent
3
+ Version: 0.1.0b1
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
+ Provides-Extra: dev
26
+ Requires-Dist: build; extra == 'dev'
27
+ Requires-Dist: mypy; extra == 'dev'
28
+ Requires-Dist: pip-audit; extra == 'dev'
29
+ Requires-Dist: ruff; extra == 'dev'
30
+ Requires-Dist: tomli; (python_version < '3.11') and extra == 'dev'
31
+ Requires-Dist: twine; extra == 'dev'
32
+ Requires-Dist: types-pyyaml; extra == 'dev'
33
+ Description-Content-Type: text/markdown
34
+
35
+ # Robert
36
+
37
+ [English](README.md) | [简体中文](README_ZH.md)
38
+
39
+ **Your Repo Teammate**
40
+
41
+ An AI teammate that takes care of your GitHub work.
42
+
43
+ Robert is a self-hosted GitHub teammate that turns trusted issues, mentions,
44
+ assignments, reviews, and follow-up comments into controlled coding-agent work.
45
+ It coordinates local workers, isolates repository work in Git worktrees,
46
+ audits proposed GitHub actions, and stores durable workstream state in SQLite.
47
+
48
+ ## What Robert Is
49
+
50
+ Robert is a local control plane for trusted GitHub collaboration. It discovers
51
+ authorized work, routes it to a configured worker, supervises execution, audits
52
+ the proposed GitHub actions, and publishes only actions allowed by the route.
53
+
54
+ ## Why Robert Exists
55
+
56
+ Coding agents are useful, but unattended GitHub automation needs durable state,
57
+ clear trust boundaries, isolated workspaces, deduplication, and evidence.
58
+ Robert provides those controls without requiring a GitHub App or hosted service.
59
+
60
+ ## Key Capabilities
61
+
62
+ - Trusted issue, pull-request, review, assignment, and mention handling.
63
+ - Multi-repository workstreams stored in SQLite.
64
+ - Per-route worker, required-skill, and recommended-skill configuration.
65
+ - Isolated Git worktrees for analysis, implementation, and source review.
66
+ - Native systemd user services and macOS LaunchAgents.
67
+ - Read-only local web UI with an explicitly enabled writable mode.
68
+ - Optional read-only OpenClaw chat commands.
69
+ - Safe migration from the former `dd-github-agent` state directory.
70
+
71
+ ## How It Works
72
+
73
+ ```mermaid
74
+ flowchart LR
75
+ A[Poll GitHub with gh] --> B[Normalize and authorize]
76
+ B --> C[Create or resume workstream]
77
+ C --> D[Resolve route and skills]
78
+ D --> E[Prepare isolated workspace]
79
+ E --> F[Run configured worker]
80
+ F --> G[Audit structured result]
81
+ G -->|Accepted| H[Deduplicate and publish]
82
+ G -->|Blocked| I[Persist failure evidence]
83
+ H --> J[(SQLite state)]
84
+ I --> J
85
+ ```
86
+
87
+ Robert polls GitHub through the authenticated `gh` CLI, normalizes events,
88
+ checks repository-specific trust rules, creates or resumes a workstream, selects
89
+ a route, prepares a task workspace, launches a local worker, audits its
90
+ structured result, and deduplicates approved GitHub actions before publication.
91
+
92
+ ## Security and Trust
93
+
94
+ GitHub text is untrusted input. Only configured actors can trigger work.
95
+ Repository overrides cannot change immutable route permissions or workspace
96
+ policy. Worker environments use an allowlist, credentials are never stored in
97
+ Robert configuration, and GitHub-facing text passes the redaction and audit
98
+ gates. The web UI binds to `127.0.0.1` by default.
99
+
100
+ ## Requirements
101
+
102
+ - Linux or macOS. Windows is supported through WSL.
103
+ - Python 3.10 or newer.
104
+ - Git and GitHub CLI (`gh`) with an authenticated session.
105
+ - At least one local worker command such as Codex.
106
+ - `pipx` is recommended for installation.
107
+
108
+ ## Quick Start
109
+
110
+ ```bash
111
+ pipx install robert-github-agent
112
+ gh auth login
113
+ robert init
114
+ robert doctor
115
+ robert service install
116
+ robert service start
117
+ ```
118
+
119
+ The configuration is written to `~/.config/robert/config.yml`. Runtime data is
120
+ stored under `~/.local/share/robert/`.
121
+
122
+ ## Configuration
123
+
124
+ Robert uses versioned YAML. Configure the GitHub account, worker definitions,
125
+ skill search paths, route overrides, and one or more repository checkouts.
126
+ See [docs/reference.md](docs/reference.md#configuration).
127
+
128
+ ## Worker Adapters
129
+
130
+ Built-in adapters support `codex`, `tcodex`, `cbc`, and a generic `command`
131
+ adapter. A worker definition chooses its adapter, executable, default model,
132
+ effort, timeout, prompt transport, and environment-variable allowlist.
133
+
134
+ ## Route Skills
135
+
136
+ Each route can declare required and recommended skills. Missing required skills
137
+ block that task before a worktree or worker is created. Missing recommended
138
+ skills appear in doctor output but do not block execution.
139
+
140
+ ## Multiple Repositories
141
+
142
+ Each repository has its own checkout, worktree root, trusted actors, concurrency
143
+ limit, and optional route overrides. A failure in one repository does not stop
144
+ other repository pipelines in the same cycle.
145
+
146
+ ## Daemon Service
147
+
148
+ ```bash
149
+ robert service install
150
+ robert service start
151
+ robert service status
152
+ ```
153
+
154
+ Robert runs in the foreground under systemd user services or launchd. Use
155
+ `robert daemon run` for direct foreground operation.
156
+
157
+ ## Local Web UI
158
+
159
+ ```bash
160
+ robert web run
161
+ ```
162
+
163
+ The default server is local and read-only. Writable mode requires:
164
+
165
+ ```bash
166
+ robert web run --writable --operator "$USER"
167
+ ```
168
+
169
+ Non-loopback binding also requires `--allow-remote` and an authenticated reverse
170
+ proxy.
171
+
172
+ ## OpenClaw
173
+
174
+ ```bash
175
+ robert openclaw install
176
+ robert openclaw status
177
+ ```
178
+
179
+ The optional plugin exposes read-only Robert status, task, run, and artifact
180
+ commands. It never schedules or starts Robert.
181
+
182
+ ## Migration
183
+
184
+ Preview and import legacy state:
185
+
186
+ ```bash
187
+ robert migrate dd-github-agent --dry-run
188
+ robert migrate dd-github-agent
189
+ ```
190
+
191
+ Migration creates a separate backup and preserves legacy deduplication markers.
192
+
193
+ ## Troubleshooting
194
+
195
+ Run `robert doctor --output json`, check `robert service status`, and export a
196
+ redacted support archive with:
197
+
198
+ ```bash
199
+ robert diagnostics export --output robert-diagnostics.zip
200
+ ```
201
+
202
+ Do not attach private repository content or credentials to public issues.
203
+
204
+ ## Contributing
205
+
206
+ Read [COMMUNITY.md](COMMUNITY.md), run the documented verification commands,
207
+ and sign commits with `git commit -s`. Robert uses the Developer Certificate
208
+ of Origin and does not require a CLA for the first beta.
209
+
210
+ ## Project Status
211
+
212
+ Robert `0.1.0b1` is a public beta. Polling is the only GitHub event transport in
213
+ this release. Interfaces may evolve before the first stable release.
214
+
215
+ ## License
216
+
217
+ Apache License 2.0. See `LICENSE`.
@@ -0,0 +1,111 @@
1
+ robert_agent/__init__.py,sha256=2f9m0YyP0UybST_fqXzfDdE3BUiRQVajDfkzhl26WPw,24
2
+ robert_agent/acceptance.py,sha256=5OsR5uVfuF74gg-InjWHPE1no2ssT1ROVrgoyeDzUQI,13344
3
+ robert_agent/acceptance_suite.py,sha256=mREr2ox9l3oA4t7UpW3fmDxK5Z8cKcmVSj3bz7r5iR8,10556
4
+ robert_agent/audit_result.py,sha256=9A1NyCuXyzYlMY5nZrr7IUMoZ7OELVMnA21jorTBRxo,18450
5
+ robert_agent/authorize.py,sha256=knoktityaSSPDj20qye49zm6ah8v5LvNqy9F8pGpHzE,4793
6
+ robert_agent/board.py,sha256=B9mG2tvDvgCgHoaCMawPmEu7D_-6oi8le61T2uwUh9A,19208
7
+ robert_agent/chat_status.py,sha256=z3OxeVvNOs_iXng87-Cm4rzia0Ew5B6CkQY8a_qJpxw,11436
8
+ robert_agent/common.py,sha256=-N54xy6X6MW5GaZC4PtiwxZCu6N95ZT8IcGco4Lj4fg,134
9
+ robert_agent/controlled_e2e_acceptance.py,sha256=y9_SdOKmGwNBEOnJ7p_4ep59pWrYZv9WztMkDRVLYXM,13209
10
+ robert_agent/daemon.py,sha256=whFy9P4kkZ5TjH-PoKacwoPfb9XrL0grbAOlC0PASgo,19317
11
+ robert_agent/daemon_state.py,sha256=ZzLDRmipk7MUDEIJEubplHW0zpvDDYSdDbhub0XVbnk,8890
12
+ robert_agent/diagnostics.py,sha256=w0-xzfjPBT432gQ99wfMcg8ulxtcImmR4JDuhLiCoq8,3447
13
+ robert_agent/discover.py,sha256=nNvjLFCKmWhcO0M_Y1kxI2V17zxqfqn70X6lM5FVjlE,25993
14
+ robert_agent/dispatch.py,sha256=cINeIkMOqde6z-bi-UOQgJ6pcaGRXIYud6aecdIlAqg,6659
15
+ robert_agent/doctor.py,sha256=EyweM89QY1mgxGvNOHX7ZvfRaq_dwwiiD5Mc2aXs928,2686
16
+ robert_agent/github_api.py,sha256=_zGBnw9IMcv8g0umeTVsLtDQX46J1zqr4gUHQ7scBsg,380
17
+ robert_agent/init_config.py,sha256=N_HDmBkZ50tWr5brXSAhonTKPRcIN0VAGdZprH2ZicI,3464
18
+ robert_agent/live_discovery_acceptance.py,sha256=4Sh5av3iI0e0B0x-nPbzKhatUpKco1_Odh5LDfGwAwk,2383
19
+ robert_agent/live_worker_acceptance.py,sha256=4QIXnCS6rUNqz42jusDFr-z_o0KAuLR55gB_qwRKm-0,12234
20
+ robert_agent/live_worktree_acceptance.py,sha256=I7Gcj3PcVUOn6QSYRD28Grus0xGqdQ4L1rVauqD5iC8,11048
21
+ robert_agent/loop_engine.py,sha256=b1Ff4K6amm2bfItutQ3fp8KQ6_8WqV9naYwXzDVQYjc,10301
22
+ robert_agent/memory_curator.py,sha256=e9QJKrzFdKMjZQ4pScQWoB0JWGiGeLL_f1jd-nHvdQ8,3645
23
+ robert_agent/migrate.py,sha256=yvKJ5OrtrUcXtxlKMonMrfrcNmaw-dO_Su4i7DYi17U,5130
24
+ robert_agent/notify.py,sha256=FbQimU9c2I1Vg_SHsYTWsttCN7H2QbuutVvl3aSRzP8,2234
25
+ robert_agent/paths.py,sha256=idyC6ptv-voaBtkVDlarIkS9ShuaLR-WhANR-xzERsQ,450
26
+ robert_agent/production_write_canary.py,sha256=ajkJU8GKpAhL3Ca6TPbcrOrIg7na-BofitWhgbv9iQU,8664
27
+ robert_agent/project_memory.py,sha256=CAq_B5_C78NSSTP7aatE_trWRQqbQs8wqgUuaMKerIs,16863
28
+ robert_agent/publish.py,sha256=q8XuWRgtSisHlQpWQJ1Y-Ce1xPDNDx7VlIVYMR26pSA,24457
29
+ robert_agent/publish_dedupe_acceptance.py,sha256=mnADzc691IZCiSjGFVyJwwpGfqqZpkLakDRT9lMWW9c,8863
30
+ robert_agent/redaction.py,sha256=Iw2vg7ug7B0ybqcUEzCampN25VlvBcpzG2LqI8UknGY,1588
31
+ robert_agent/render_prompt.py,sha256=nNVMddfad_TaRIMoErvhSinix78_JoBdHCtFP4sH-ls,23927
32
+ robert_agent/resource_files.py,sha256=vjVWGF0Md2EbwA5On2I_lAvvEnNDHmYTHtv2sldyUgY,196
33
+ robert_agent/route.py,sha256=m9bY-5YM7HbQxQgTKCx3a2P1oIsqBd8x4CWN-N92w-M,7558
34
+ robert_agent/route_config.py,sha256=DqJHthIkKujD_o9KoI8HyYTj-PY5wI2pB77x9uL76yc,1868
35
+ robert_agent/run_once.py,sha256=dhx0j7VkZi8RaWEUtoe5FhrAU4hy2idtR0pLzdjsinQ,179160
36
+ robert_agent/runtime_knowledge.py,sha256=gZ3vl0ebkAUNjFBzyjRIpYXOiZhrAbzCCwCWrnjnVdo,12448
37
+ robert_agent/service.py,sha256=uvHDKLUqWEdzToXILgHqd16i0yik0KaFDqCINMwDfx0,4386
38
+ robert_agent/skills.py,sha256=ko7yGiIOwzWmdQlIgUDRdk0atj-ZcYApxnBNSt0HnAM,845
39
+ robert_agent/status.py,sha256=EmNzLsyZuQH5PDO2PBYE6YK9HmFSWNHQ4A3P6KkaPJ8,36329
40
+ robert_agent/storage.py,sha256=tc0d6jmftcZFf07Iy-cg0t4l_ZVrCgrN-CMUG_tFOSk,12107
41
+ robert_agent/summarize.py,sha256=o0yR5a2fynFRclRpbRpxqkZsS33QoD0SadfOMkdqLd0,3013
42
+ robert_agent/supervise.py,sha256=h00x1Iynqdvf_u80rov25W0HkM6B1JR2TuXObtiWMlM,2104
43
+ robert_agent/usage.py,sha256=qTVDkzmDuF5QGyQv6XvfMj6kKG9lgJyAQeUuDlhGJPA,6580
44
+ robert_agent/validate_config.py,sha256=L4Zx9aVaZP1HeFyesrIot8Np_CrBs7mUkBV2Dlus0-g,23468
45
+ robert_agent/wakeup.py,sha256=U53C9Pevp1Z8TVmLrhXFjI1Exyluc0G29XnNsfm_H4s,6990
46
+ robert_agent/web.py,sha256=riG1tYhpjyFBGTAgltUs1uHwK0GntunYK5LgbQouCGM,170576
47
+ robert_agent/work_items.py,sha256=A_7I9iw6jif-84caJUwwYu81pbecYlptmHX_Yy1fGmg,35117
48
+ robert_agent/workbench.py,sha256=-JwOjWzzzZwRPZz_bezTDQRV7i1vRvCQe45sOLM-bn8,23910
49
+ robert_agent/worker_heartbeat.py,sha256=pDLMJC2RPOPWWmSIx3ojtJkKJjEIZYL6UiFx2FxHJjg,128
50
+ robert_agent/worker_result.py,sha256=JfLLfuXkIRBLSTaAQ75yCCi7Lls1xCEVuq_ku19Rbgo,125
51
+ robert_agent/worker_snapshot.py,sha256=lMeY87XC218nwCJ84sxsU6wYEcI3ocxRPaDyYAWiTWM,127
52
+ robert_agent/workstream.py,sha256=Qbp12N9val7ZMFUuXhR0ZcHOH08HfiY1hqNvNULfX8c,1521
53
+ robert_agent/worktree.py,sha256=6JHMRkLg_poIBnf1rNc3A8t4LxK42aRttiRNykNuyaM,9458
54
+ robert_agent/cli/__init__.py,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
55
+ robert_agent/cli/exit_codes.py,sha256=w8nfq3NnWYCoRELZDn5SztNdOJVFa82wxEIrHDUBkvI,83
56
+ robert_agent/cli/main.py,sha256=DWVRg_6zIpTDQmwy9b3ubpe9h2J1cwmTz3eW4xK6i3s,17723
57
+ robert_agent/cli/output.py,sha256=dhjXDtSM0hF6sjbyhcvys7MvEbkuT1jAwS7lc5kropo,568
58
+ robert_agent/integrations/__init__.py,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
59
+ robert_agent/integrations/openclaw.py,sha256=_XIE69KbraAtWpHbyOkk8Mr2nJHxQu6tFp2VSDqWgdI,7193
60
+ robert_agent/resources/__init__.py,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
61
+ robert_agent/resources/acceptance-matrix.md,sha256=eSIuPCQyM2qp5SVMIk16MO5YddLrR1xerPjXoEMaEDs,9952
62
+ robert_agent/resources/classifier.md,sha256=032OWu1QGaXrxfiG-kD8mwlz7yZh8siwxifsk_3kk3Y,932
63
+ robert_agent/resources/command-matrix.md,sha256=zgd3tVypL0VIGIp6MblNaLd1VJ-kKqiowSuQS_3NtUA,4458
64
+ robert_agent/resources/config.example.yml,sha256=nKZrZUX5oCgLbvqn7md0fGVHM2iginHy6VvSIQ3LBm8,267
65
+ robert_agent/resources/failure-modes.md,sha256=miA9qP7wN3TdLNjPzqsriuQdIIQQicQxLxkKVgjhYXY,1601
66
+ robert_agent/resources/github-events.md,sha256=mMbYxoicp_pRChp1csZDQmeJbUWX-Gfd1lCh5gMhk1w,5778
67
+ robert_agent/resources/kanban-control.md,sha256=8RNEqRjDLh8Y5NCsfZ_NR9P1mM-QJezTUu60HQ-lo8U,7248
68
+ robert_agent/resources/redaction.md,sha256=bTkK0d0Db7BsCczP45E7WWUtw1Kq9gBE4uIMQqcbx_s,562
69
+ robert_agent/resources/result-contract.md,sha256=JeCqCej4fbCVkR1-DUMcdpSTKIqaUTMF9sjB7hks09w,2900
70
+ robert_agent/resources/routes.yml,sha256=nSgBUKC7mN7VxowkLRb5j0r0J9bQF4C1BCElQEnXHtI,2722
71
+ robert_agent/resources/trust-model.md,sha256=KEwjVnJVnlqYBplEbldaHcc9A5tSyuk1NQt60Ngvwjk,1037
72
+ robert_agent/resources/worker-prompt.md,sha256=z8eYV3vP1-e-V1f-lt3BQyEnovpBO3kCzdNJoPnf7kw,7132
73
+ robert_agent/resources/worker-protocol.md,sha256=iPAOWxTxx8bwnjWvx3_q9Op4PKSZ5rJG2_KPtAdWLV8,2410
74
+ robert_agent/resources/workflow.yml,sha256=Vw2ZEeA3DrKMuBzNdZdPcm4PHOhhVGqlgIpqkOvlw9M,1477
75
+ robert_agent/resources/workstream-model.md,sha256=qoSc7wVoGyxGNzvLetkP4VISe277BLfIeZC1juEGGKs,845
76
+ robert_agent/resources/db/schema.sql,sha256=9-mZiJt_IrSZeqCEf6zObf-3ocq2tiRzm4hramVm7aA,18397
77
+ robert_agent/resources/db/migrations/001_legacy_dd_to_robert.sql,sha256=WGbXbDGISnrG4P8U4qmXxOarnIeNOGcEOnkhNaqxpAY,312
78
+ robert_agent/resources/fixtures/actor-permission.json,sha256=REZu7YtTvU-C41svIdMTSilpW4WTR18AusbV681ujaQ,15
79
+ robert_agent/resources/fixtures/discovery.json,sha256=xADuW5pHFtn0Coo2EKXxlNQaMdXb0F5FEAqu40s-3PY,15
80
+ robert_agent/resources/fixtures/redaction.json,sha256=81A5DHlzb6UTb1h27-SJs0pw9yqvFNWwpSRRGE5i5Nc,14
81
+ robert_agent/resources/fixtures/review-followup.json,sha256=vvFmAB3dMEepwbuuLP81jIuR0wfIfLVueVDBgZ2hP3w,16
82
+ robert_agent/resources/fixtures/worker-results.json,sha256=UAGv6wyWkbUM7sG_jdBQBDWVlCvNJlVI3n1ALarrpYQ,16
83
+ robert_agent/resources/fixtures/workstreams.json,sha256=In0EtXotP5i3vx8gsaxAWyUDV0vDcZ2GcX1-UwyCVIw,20
84
+ robert_agent/resources/schemas/config.schema.json,sha256=fZH0nWd0sT5INeMrqx2qA1wjXPeF_DibbNYgYOBXwSw,3464
85
+ robert_agent/resources/schemas/event.schema.json,sha256=n_mIpWzHAJnXjcVDGiuexPE16rIZ4-ya34_CisW6z9Y,604
86
+ robert_agent/resources/schemas/result.schema.json,sha256=jw6Q6rcLYquqNi9B_S-63aC28m0NHcYFsxL1V2ep-i8,3386
87
+ robert_agent/resources/schemas/route.schema.json,sha256=bL1Od4LKGcxki22blRFcE4GMiWdUQZJWCRn5pdAboDo,683
88
+ robert_agent/resources/schemas/snapshot.schema.json,sha256=oMEe0mFZk8lqOVXW00L8V--7zmYS2ZAhpdzP-CnRrfI,535
89
+ robert_agent/resources/schemas/task.schema.json,sha256=KR9BL37aAMWUVJlvqH8EwznCU7EZwfCdDpM-jiP4rBI,486
90
+ robert_agent/web_assets/board.css,sha256=ppvmNQdnmtxVv6qjM5OcJk62mOaAQYUTiEfWdM68LxY,12713
91
+ robert_agent/web_assets/board.html,sha256=uqTgAlcj7MvkblaTfoiw3ni6RZVLghxshCTRQ-xRPY0,10603
92
+ robert_agent/web_assets/board.js,sha256=-vk55hfV_hmbknoM8bI7-SokH7X70QEdNWBHgiPaigk,27561
93
+ robert_agent/web_assets/github-shell.css,sha256=bk-JY_XHgjVytTrejgwcJNd30506PSIeubPmkF7dxLw,6565
94
+ robert_agent/web_assets/index.html,sha256=x0PBsP1iEdJv8YGyJWBFKxdQCna0EUKorr7OOTMfsZU,7826
95
+ robert_agent/web_assets/operations.css,sha256=-bNdKqzQryDD_AlXWx3kHWqvwnRn9vaYwy0ZR2V8xYs,5728
96
+ robert_agent/web_assets/workbench.css,sha256=tA2bjPswCNxsrS7XAOR3twvH-WSPcbMxbZ5OvpzRroc,12076
97
+ robert_agent/web_assets/workbench.js,sha256=u5a-q48QwyqGVXPDh4zDR8r5NPY2XEgLAzGZYhmMNgA,31071
98
+ robert_agent/worker/__init__.py,sha256=QYlcktM0404pRSYog8sZTb_5owCLx1pA1oOXUYhbmtM,37
99
+ robert_agent/worker/heartbeat.py,sha256=noSUiVu67_Q0VuPoF-KbYvdr4oYc0rgxwOiylqsSLPE,6303
100
+ robert_agent/worker/result.py,sha256=_MDeJEI1gEy9HV26InZxAgQPYBLof8cb9VE-8ph4uyA,12195
101
+ robert_agent/worker/snapshot.py,sha256=C0r2taEtOQefKTOirTjwGF9-a-iO8aeyulcfDgtJZ7o,3188
102
+ robert_agent/worker_adapters/__init__.py,sha256=hBCHxrDrA_-T136LMC7tZRFtWpum5ItiwVB6TELMOIo,4650
103
+ robert_agent/worker_adapters/cbc.py,sha256=A2rOtBpsmgaMDVewEzl6Lyk0QuO8xqAMVcmTVDiqcfw,1607
104
+ robert_agent/worker_adapters/codex.py,sha256=StrNts4K9Hn8cAgJ0GcsPNs7AjLyfXSSWGJNx29Bqbw,1363
105
+ robert_agent/worker_adapters/command.py,sha256=FPTsqy7peISwQ-xejMe_QeXluq0591ToyGAE28CB668,889
106
+ robert_agent/worker_adapters/tcodex.py,sha256=j54VKwmwKxpO_cUlceaBz3yTnefBzzhhXKZiSALFyvY,1365
107
+ robert_github_agent-0.1.0b1.dist-info/METADATA,sha256=MykLTm3A_6eu3B3K6s3D9zoeSV-K6rYkEb8XBfMK-FI,7064
108
+ robert_github_agent-0.1.0b1.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
109
+ robert_github_agent-0.1.0b1.dist-info/entry_points.txt,sha256=AAfBjGSCLZHb5JCN3xtkWbwDsezLMO3E0lo42usscXE,54
110
+ robert_github_agent-0.1.0b1.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
111
+ robert_github_agent-0.1.0b1.dist-info/RECORD,,
@@ -0,0 +1,4 @@
1
+ Wheel-Version: 1.0
2
+ Generator: hatchling 1.31.0
3
+ Root-Is-Purelib: true
4
+ Tag: py3-none-any
@@ -0,0 +1,2 @@
1
+ [console_scripts]
2
+ robert = robert_agent.cli.main:main