mirror of
https://github.com/rennf93/roboco.git
synced 2026-08-03 07:23:24 +02:00
* feat(release): add release-manager feature flag (default off) * feat(release): change classification + semver-bump derivation * feat(release): readiness audit (changelog/version-ref/docs/migration/gate) * feat(release): release-manager engine proposes a gated release * feat(release): fail-closed release executor (bump, gate, publish) * feat(release): CEO approve/reject release-proposal surface * docs(release): document the gated release manager * feat(memory): add org-memory feature flags (default off) * feat(memory): add playbooks table + status enum + migration * feat(memory): playbook service with auditor curation transitions * feat(memory): playbooks RAG index plugin * feat(memory): index a playbook into RAG on approval * feat(memory): distill a high-signal lesson at task completion * feat(memory): keep private journal reflections out of the shared RAG corpus * feat(memory): draft_playbook verb + auditor curation verbs * fix(ci): resolve mypy tests/ errors blocking the gate (UUID casts, annotations) * feat(memory): auto-inject similar lessons/playbooks into the briefing * feat(memory): auditor playbook review queue (api + panel) * docs(memory): document the org-memory loop + playbook verbs * fix(provisioning): idempotent pitch provisioning (reuse product/project by slug on re-approval) * fix(memory): add chunks_playbooks to the chunk schema + isolate release route tests - Migration 030's CHUNK_TABLES was missing chunks_playbooks, breaking the IndexType<->migration parity guard once the PLAYBOOKS index landed. The upgrade is ALTER ... IF EXISTS so adding it is safe on any DB shape. - The release-route fixture's approve/reject paths call db.commit() (real behavior), so a held proposal outlived the per-test rollback and leaked into engine tests that read the global list_open_release_proposals(). Tear down source=release_manager rows after each test. - Make the gather_snapshot real-repo smoke version-agnostic (semver match) so it stops pinning the literal repo version. * chore(release): 0.13.0 * ++ --------- Co-authored-by: Renn F <rennf93@users.noreply.github.com>
285 lines
16 KiB
Markdown
285 lines
16 KiB
Markdown
<!-- AUTOGENERATED by scripts/regenerate_verb_tables.py. -->
|
|
<!-- Source: services/gateway/role_config.py + api/schemas/v1/. -->
|
|
|
|
# Per-role verb shapes (autogenerated)
|
|
|
|
Run `uv run python scripts/regenerate_verb_tables.py` after changing
|
|
any role config or schema. Role prompts reference this file's sections
|
|
as the source of truth for verb signatures.
|
|
|
|
Driver-based roles (prompter, secretary) are intentionally omitted — their
|
|
real tools live in their agent_sdk drivers, not role_config.
|
|
|
|
## developer
|
|
|
|
### Flow verbs
|
|
|
|
| Verb | Body schema |
|
|
|------|-------------|
|
|
| `give_me_work` | `give_me_work()` |
|
|
| `i_am_blocked` | `i_am_blocked(task_id: UUID, reason: str, blocker_type: str | None = None, what_needed: str | None = None)` |
|
|
| `i_am_done` | `i_am_done(task_id: UUID, notes: str = '')` |
|
|
| `i_am_idle` | `i_am_idle()` |
|
|
| `i_will_work_on` | `i_will_work_on(task_id: UUID, plan: str | None = None, steps: list[str | str] = PydanticUndefined, technical_considerations: list[str] = PydanticUndefined, risks: list[str | str] = PydanticUndefined, open_questions: list[str | str | bool] = PydanticUndefined)` |
|
|
| `open_pr` | `open_pr(task_id: UUID)` |
|
|
| `resume` | `resume(task_id: UUID)` |
|
|
| `unclaim` | `unclaim(task_id: UUID)` |
|
|
|
|
### Content (do) tools
|
|
|
|
| Tool | Body schema |
|
|
|------|-------------|
|
|
| `commit` | `commit(message: str, files: list[str] | None = None)` |
|
|
| `note` | `note(text: str, scope: str = 'note', task_id: UUID | None = None, title: str | None = None, context: str = '', options: list[str | str] | None = None, chosen: str = '', rationale: str = '', consequences: list[str] | None = None, what_done: str = '', what_learned: str = '', what_struggled: str = '', next_steps: list[str] | None = None, section: str | Any | None = None)` |
|
|
| `say` | `say(channel: str, text: str, task_id: UUID | None = None)` |
|
|
| `dm` | `dm(recipient: str, text: str, task_id: UUID | None = None, skill: str | None = None)` |
|
|
| `evidence` | `evidence(task_id: UUID)` |
|
|
| `progress` | `progress(task_id: UUID, message: str, plan_step: str | None = None, percentage: int | None = None)` |
|
|
| `pr_update` | `pr_update(see do_server)` |
|
|
| `draft_playbook` | `draft_playbook(title: str, problem: str, procedure: str, tags: list[str] = PydanticUndefined, source_task_id: UUID | None = None)` |
|
|
| `notify_list` | `notify_list(unread_only: bool = True, pending_ack_only: bool = False, limit: int = 20)` |
|
|
| `notify_get` | `notify_get(notification_id: UUID)` |
|
|
| `notify_ack` | `notify_ack(notification_id: UUID)` |
|
|
| `read_messages` | `read_messages()` |
|
|
| `channels` | `channels()` |
|
|
|
|
## qa
|
|
|
|
### Flow verbs
|
|
|
|
| Verb | Body schema |
|
|
|------|-------------|
|
|
| `claim_review` | `claim_review(task_id: UUID)` |
|
|
| `fail_review` | `fail_review(task_id: UUID, issues: list[str])` |
|
|
| `give_me_work` | `give_me_work()` |
|
|
| `i_am_blocked` | `i_am_blocked(task_id: UUID, reason: str, blocker_type: str | None = None, what_needed: str | None = None)` |
|
|
| `i_am_idle` | `i_am_idle()` |
|
|
| `pass_review` | `pass_review(task_id: UUID, notes: str, ac_verdicts: list[str] | None = None)` |
|
|
| `resume` | `resume(task_id: UUID)` |
|
|
| `unclaim` | `unclaim(task_id: UUID)` |
|
|
|
|
### Content (do) tools
|
|
|
|
| Tool | Body schema |
|
|
|------|-------------|
|
|
| `note` | `note(text: str, scope: str = 'note', task_id: UUID | None = None, title: str | None = None, context: str = '', options: list[str | str] | None = None, chosen: str = '', rationale: str = '', consequences: list[str] | None = None, what_done: str = '', what_learned: str = '', what_struggled: str = '', next_steps: list[str] | None = None, section: str | Any | None = None)` |
|
|
| `say` | `say(channel: str, text: str, task_id: UUID | None = None)` |
|
|
| `dm` | `dm(recipient: str, text: str, task_id: UUID | None = None, skill: str | None = None)` |
|
|
| `evidence` | `evidence(task_id: UUID)` |
|
|
| `draft_playbook` | `draft_playbook(title: str, problem: str, procedure: str, tags: list[str] = PydanticUndefined, source_task_id: UUID | None = None)` |
|
|
| `notify_list` | `notify_list(unread_only: bool = True, pending_ack_only: bool = False, limit: int = 20)` |
|
|
| `notify_get` | `notify_get(notification_id: UUID)` |
|
|
| `notify_ack` | `notify_ack(notification_id: UUID)` |
|
|
| `read_messages` | `read_messages()` |
|
|
| `channels` | `channels()` |
|
|
|
|
## documenter
|
|
|
|
### Flow verbs
|
|
|
|
| Verb | Body schema |
|
|
|------|-------------|
|
|
| `claim_doc_task` | `claim_doc_task(task_id: UUID)` |
|
|
| `give_me_work` | `give_me_work()` |
|
|
| `i_am_blocked` | `i_am_blocked(task_id: UUID, reason: str, blocker_type: str | None = None, what_needed: str | None = None)` |
|
|
| `i_am_idle` | `i_am_idle()` |
|
|
| `i_documented` | `i_documented(task_id: UUID, notes: str, files: list[str])` |
|
|
| `resume` | `resume(task_id: UUID)` |
|
|
| `unclaim` | `unclaim(task_id: UUID)` |
|
|
|
|
### Content (do) tools
|
|
|
|
| Tool | Body schema |
|
|
|------|-------------|
|
|
| `commit` | `commit(message: str, files: list[str] | None = None)` |
|
|
| `note` | `note(text: str, scope: str = 'note', task_id: UUID | None = None, title: str | None = None, context: str = '', options: list[str | str] | None = None, chosen: str = '', rationale: str = '', consequences: list[str] | None = None, what_done: str = '', what_learned: str = '', what_struggled: str = '', next_steps: list[str] | None = None, section: str | Any | None = None)` |
|
|
| `say` | `say(channel: str, text: str, task_id: UUID | None = None)` |
|
|
| `dm` | `dm(recipient: str, text: str, task_id: UUID | None = None, skill: str | None = None)` |
|
|
| `evidence` | `evidence(task_id: UUID)` |
|
|
| `progress` | `progress(task_id: UUID, message: str, plan_step: str | None = None, percentage: int | None = None)` |
|
|
| `pr_update` | `pr_update(see do_server)` |
|
|
| `draft_playbook` | `draft_playbook(title: str, problem: str, procedure: str, tags: list[str] = PydanticUndefined, source_task_id: UUID | None = None)` |
|
|
| `notify_list` | `notify_list(unread_only: bool = True, pending_ack_only: bool = False, limit: int = 20)` |
|
|
| `notify_get` | `notify_get(notification_id: UUID)` |
|
|
| `notify_ack` | `notify_ack(notification_id: UUID)` |
|
|
| `read_messages` | `read_messages()` |
|
|
| `channels` | `channels()` |
|
|
|
|
## cell_pm
|
|
|
|
### Flow verbs
|
|
|
|
| Verb | Body schema |
|
|
|------|-------------|
|
|
| `complete` | `complete(task_id: UUID, notes: str)` |
|
|
| `delegate` | `delegate(parent_task_id: UUID, title: str, description: str, assigned_to: str, team: str, task_type: str, nature: str, estimated_complexity: str, acceptance_criteria: list[str], project_id: UUID | None = None, covers_parent_criteria: list[str] | None = None)` |
|
|
| `escalate_up` | `escalate_up(task_id: UUID, reason: str)` |
|
|
| `give_me_work` | `give_me_work()` |
|
|
| `i_am_idle` | `i_am_idle()` |
|
|
| `i_will_plan` | `i_will_plan(task_id: UUID, plan: str, approach: str, sub_tasks: list[str | str] = PydanticUndefined, technical_considerations: list[str] = PydanticUndefined, risks: list[str | str] = PydanticUndefined, open_questions: list[str | str | bool] = PydanticUndefined)` |
|
|
| `reassign` | `reassign(task_id: UUID, new_assignee: str)` |
|
|
| `resume` | `resume(task_id: UUID)` |
|
|
| `submit_up` | `submit_up(task_id: UUID, notes: str)` |
|
|
| `triage` | `triage()` |
|
|
| `unblock` | `unblock(task_id: UUID, reason: str, restore: bool = True)` |
|
|
| `unclaim` | `unclaim(task_id: UUID)` |
|
|
|
|
### Content (do) tools
|
|
|
|
| Tool | Body schema |
|
|
|------|-------------|
|
|
| `note` | `note(text: str, scope: str = 'note', task_id: UUID | None = None, title: str | None = None, context: str = '', options: list[str | str] | None = None, chosen: str = '', rationale: str = '', consequences: list[str] | None = None, what_done: str = '', what_learned: str = '', what_struggled: str = '', next_steps: list[str] | None = None, section: str | Any | None = None)` |
|
|
| `say` | `say(channel: str, text: str, task_id: UUID | None = None)` |
|
|
| `dm` | `dm(recipient: str, text: str, task_id: UUID | None = None, skill: str | None = None)` |
|
|
| `notify` | `notify(target: str, text: str, priority: str = 'normal', task_id: UUID | None = None)` |
|
|
| `evidence` | `evidence(task_id: UUID)` |
|
|
| `open_session` | `open_session(task_id: UUID, channel: str, topic: str, relationship_type: str = 'discussion', group_id: UUID | None = None)` |
|
|
| `link_session` | `link_session(session_id: UUID, task_id: UUID, is_primary: bool = False, relationship_type: str = 'discussion')` |
|
|
| `pr_update` | `pr_update(see do_server)` |
|
|
| `draft_playbook` | `draft_playbook(title: str, problem: str, procedure: str, tags: list[str] = PydanticUndefined, source_task_id: UUID | None = None)` |
|
|
| `notify_list` | `notify_list(unread_only: bool = True, pending_ack_only: bool = False, limit: int = 20)` |
|
|
| `notify_get` | `notify_get(notification_id: UUID)` |
|
|
| `notify_ack` | `notify_ack(notification_id: UUID)` |
|
|
| `read_messages` | `read_messages()` |
|
|
| `channels` | `channels()` |
|
|
|
|
## main_pm
|
|
|
|
### Flow verbs
|
|
|
|
| Verb | Body schema |
|
|
|------|-------------|
|
|
| `complete` | `complete(task_id: UUID, notes: str)` |
|
|
| `delegate` | `delegate(parent_task_id: UUID, title: str, description: str, assigned_to: str, team: str, task_type: str, nature: str, estimated_complexity: str, acceptance_criteria: list[str], project_id: UUID | None = None, covers_parent_criteria: list[str] | None = None)` |
|
|
| `escalate_to_ceo` | `escalate_to_ceo(task_id: UUID, reason: str)` |
|
|
| `escalate_up` | `escalate_up(task_id: UUID, reason: str)` |
|
|
| `give_me_work` | `give_me_work()` |
|
|
| `i_am_idle` | `i_am_idle()` |
|
|
| `i_will_plan` | `i_will_plan(task_id: UUID, plan: str, approach: str, sub_tasks: list[str | str] = PydanticUndefined, technical_considerations: list[str] = PydanticUndefined, risks: list[str | str] = PydanticUndefined, open_questions: list[str | str | bool] = PydanticUndefined)` |
|
|
| `resume` | `resume(task_id: UUID)` |
|
|
| `submit_root` | `submit_root(task_id: UUID, notes: str)` |
|
|
| `triage` | `triage()` |
|
|
| `triage_all` | `triage_all()` |
|
|
| `unblock` | `unblock(task_id: UUID, reason: str, restore: bool = True)` |
|
|
| `unclaim` | `unclaim(task_id: UUID)` |
|
|
|
|
### Content (do) tools
|
|
|
|
| Tool | Body schema |
|
|
|------|-------------|
|
|
| `note` | `note(text: str, scope: str = 'note', task_id: UUID | None = None, title: str | None = None, context: str = '', options: list[str | str] | None = None, chosen: str = '', rationale: str = '', consequences: list[str] | None = None, what_done: str = '', what_learned: str = '', what_struggled: str = '', next_steps: list[str] | None = None, section: str | Any | None = None)` |
|
|
| `say` | `say(channel: str, text: str, task_id: UUID | None = None)` |
|
|
| `dm` | `dm(recipient: str, text: str, task_id: UUID | None = None, skill: str | None = None)` |
|
|
| `notify` | `notify(target: str, text: str, priority: str = 'normal', task_id: UUID | None = None)` |
|
|
| `evidence` | `evidence(task_id: UUID)` |
|
|
| `open_session` | `open_session(task_id: UUID, channel: str, topic: str, relationship_type: str = 'discussion', group_id: UUID | None = None)` |
|
|
| `link_session` | `link_session(session_id: UUID, task_id: UUID, is_primary: bool = False, relationship_type: str = 'discussion')` |
|
|
| `pr_update` | `pr_update(see do_server)` |
|
|
| `draft_playbook` | `draft_playbook(title: str, problem: str, procedure: str, tags: list[str] = PydanticUndefined, source_task_id: UUID | None = None)` |
|
|
| `notify_list` | `notify_list(unread_only: bool = True, pending_ack_only: bool = False, limit: int = 20)` |
|
|
| `notify_get` | `notify_get(notification_id: UUID)` |
|
|
| `notify_ack` | `notify_ack(notification_id: UUID)` |
|
|
| `read_messages` | `read_messages()` |
|
|
| `channels` | `channels()` |
|
|
|
|
## product_owner
|
|
|
|
### Flow verbs
|
|
|
|
| Verb | Body schema |
|
|
|------|-------------|
|
|
| `escalate_to_ceo` | `escalate_to_ceo(task_id: UUID, reason: str)` |
|
|
| `i_am_idle` | `i_am_idle()` |
|
|
| `triage` | `triage()` |
|
|
|
|
### Content (do) tools
|
|
|
|
| Tool | Body schema |
|
|
|------|-------------|
|
|
| `note` | `note(text: str, scope: str = 'note', task_id: UUID | None = None, title: str | None = None, context: str = '', options: list[str | str] | None = None, chosen: str = '', rationale: str = '', consequences: list[str] | None = None, what_done: str = '', what_learned: str = '', what_struggled: str = '', next_steps: list[str] | None = None, section: str | Any | None = None)` |
|
|
| `pitch` | `pitch(title: str, slug: str, problem: str, proposed_solution: str, target_cells: list[str])` |
|
|
| `say` | `say(channel: str, text: str, task_id: UUID | None = None)` |
|
|
| `dm` | `dm(recipient: str, text: str, task_id: UUID | None = None, skill: str | None = None)` |
|
|
| `notify` | `notify(target: str, text: str, priority: str = 'normal', task_id: UUID | None = None)` |
|
|
| `evidence` | `evidence(task_id: UUID)` |
|
|
| `open_session` | `open_session(task_id: UUID, channel: str, topic: str, relationship_type: str = 'discussion', group_id: UUID | None = None)` |
|
|
| `notify_list` | `notify_list(unread_only: bool = True, pending_ack_only: bool = False, limit: int = 20)` |
|
|
| `notify_get` | `notify_get(notification_id: UUID)` |
|
|
| `notify_ack` | `notify_ack(notification_id: UUID)` |
|
|
| `read_messages` | `read_messages()` |
|
|
| `channels` | `channels()` |
|
|
|
|
## head_marketing
|
|
|
|
### Flow verbs
|
|
|
|
| Verb | Body schema |
|
|
|------|-------------|
|
|
| `escalate_to_ceo` | `escalate_to_ceo(task_id: UUID, reason: str)` |
|
|
| `i_am_idle` | `i_am_idle()` |
|
|
| `triage` | `triage()` |
|
|
|
|
### Content (do) tools
|
|
|
|
| Tool | Body schema |
|
|
|------|-------------|
|
|
| `note` | `note(text: str, scope: str = 'note', task_id: UUID | None = None, title: str | None = None, context: str = '', options: list[str | str] | None = None, chosen: str = '', rationale: str = '', consequences: list[str] | None = None, what_done: str = '', what_learned: str = '', what_struggled: str = '', next_steps: list[str] | None = None, section: str | Any | None = None)` |
|
|
| `pitch` | `pitch(title: str, slug: str, problem: str, proposed_solution: str, target_cells: list[str])` |
|
|
| `say` | `say(channel: str, text: str, task_id: UUID | None = None)` |
|
|
| `dm` | `dm(recipient: str, text: str, task_id: UUID | None = None, skill: str | None = None)` |
|
|
| `notify` | `notify(target: str, text: str, priority: str = 'normal', task_id: UUID | None = None)` |
|
|
| `evidence` | `evidence(task_id: UUID)` |
|
|
| `open_session` | `open_session(task_id: UUID, channel: str, topic: str, relationship_type: str = 'discussion', group_id: UUID | None = None)` |
|
|
| `notify_list` | `notify_list(unread_only: bool = True, pending_ack_only: bool = False, limit: int = 20)` |
|
|
| `notify_get` | `notify_get(notification_id: UUID)` |
|
|
| `notify_ack` | `notify_ack(notification_id: UUID)` |
|
|
| `read_messages` | `read_messages()` |
|
|
| `channels` | `channels()` |
|
|
|
|
## auditor
|
|
|
|
### Flow verbs
|
|
|
|
| Verb | Body schema |
|
|
|------|-------------|
|
|
| `i_am_idle` | `i_am_idle()` |
|
|
| `triage` | `triage()` |
|
|
|
|
### Content (do) tools
|
|
|
|
| Tool | Body schema |
|
|
|------|-------------|
|
|
| `note` | `note(text: str, scope: str = 'note', task_id: UUID | None = None, title: str | None = None, context: str = '', options: list[str | str] | None = None, chosen: str = '', rationale: str = '', consequences: list[str] | None = None, what_done: str = '', what_learned: str = '', what_struggled: str = '', next_steps: list[str] | None = None, section: str | Any | None = None)` |
|
|
| `evidence` | `evidence(task_id: UUID)` |
|
|
| `approve_playbook` | `approve_playbook(playbook_id: UUID)` |
|
|
| `reject_playbook` | `reject_playbook(playbook_id: UUID, reason: str)` |
|
|
| `archive_playbook` | `archive_playbook(playbook_id: UUID)` |
|
|
| `notify_list` | `notify_list(unread_only: bool = True, pending_ack_only: bool = False, limit: int = 20)` |
|
|
| `notify_get` | `notify_get(notification_id: UUID)` |
|
|
| `channels` | `channels()` |
|
|
|
|
## pr_reviewer
|
|
|
|
### Flow verbs
|
|
|
|
| Verb | Body schema |
|
|
|------|-------------|
|
|
| `claim_gate_review` | `claim_gate_review(task_id: UUID)` |
|
|
| `claim_pr_review` | `claim_pr_review(task_id: UUID)` |
|
|
| `give_me_work` | `give_me_work()` |
|
|
| `i_am_idle` | `i_am_idle()` |
|
|
| `post_pr_review` | `post_pr_review(task_id: UUID, body: str, event: str = 'REQUEST_CHANGES', findings: list[str | Any] = PydanticUndefined)` |
|
|
| `pr_fail` | `pr_fail(task_id: UUID, issues: list[str])` |
|
|
| `pr_pass` | `pr_pass(task_id: UUID, notes: str)` |
|
|
|
|
### Content (do) tools
|
|
|
|
| Tool | Body schema |
|
|
|------|-------------|
|
|
| `note` | `note(text: str, scope: str = 'note', task_id: UUID | None = None, title: str | None = None, context: str = '', options: list[str | str] | None = None, chosen: str = '', rationale: str = '', consequences: list[str] | None = None, what_done: str = '', what_learned: str = '', what_struggled: str = '', next_steps: list[str] | None = None, section: str | Any | None = None)` |
|
|
| `evidence` | `evidence(task_id: UUID)` |
|
|
| `notify_list` | `notify_list(unread_only: bool = True, pending_ack_only: bool = False, limit: int = 20)` |
|
|
| `notify_get` | `notify_get(notification_id: UUID)` |
|
|
| `channels` | `channels()` |
|
|
|