Skip to content

docs: mark ADR-0021 implemented - #129

Merged
delete-cloud merged 1 commit into
mainfrom
feat/adr-0021-completion-doc
May 10, 2026
Merged

delete-cloud merged 1 commit into
mainfrom
feat/adr-0021-completion-doc

Conversation

@delete-cloud

@delete-cloud delete-cloud commented May 10, 2026 •

Copy link
Copy Markdown
Owner

Summary

Validation

  • uv run pytest tests/ui/test_http_server.py tests/ui/test_http_server_workspace_transfer.py tests/cli/test_remote_client.py tests/coding_agent/environment/ -k "session or workspace or remote or cancel or manifest or admin" -v
  • uv run ruff check docs/adr/0021-remote-session-and-workspace-operations-api.md
  • git diff --check

Summary by CodeRabbit

  • Documentation

    • Updated Remote Session and Workspace Operations API specification with comprehensive details on archive handling and security controls.
  • Tests

    • Completed validation of session management, workspace operations, admin authorization enforcement, cancellation behavior, and CLI remote workflows.

Review Change Stack

@coderabbitai

coderabbitai Bot commented May 10, 2026 •

Copy link
Copy Markdown
Contributor
📝 Walkthrough

Walkthrough

ADR-0021 documentation is updated with a concrete specification for Docker workspace provider archive digest computation and acceptance criteria checklist items marked as complete, confirming test coverage for session operations, admin-scope enforcement, workspace cleanup, archive manifest reporting, and CLI download workflows.

Changes

ADR-0021 Remote Session and Workspace Operations API

Layer / File(s) Summary
Archive SHA256 Specification
coding-agent/docs/adr/0021-remote-session-and-workspace-operations-api.md
Docker workspace provider archive_sha256 is computed from the exact materialized archive bytes returned by download and included in the workspace archive manifest.
Acceptance Criteria Completion
coding-agent/docs/adr/0021-remote-session-and-workspace-operations-api.md
Checklist items marked complete for session listing/status fields, admin-scope enforcement, cancel operation behavior, workspace listing/cleanup requirements, manifest reporting, endpoint alias compatibility, and CLI remote run/download confirmation flow.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Possibly related PRs

Poem

🐰 A rabbit hops through ADR-0021's halls,
Checking boxes as acceptance calls,
Archive digests, manifest complete,
Remote workspace spec—oh, what a treat!
✨📋

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title 'docs: mark ADR-0021 implemented' directly and specifically describes the primary change in the pull request, which is updating ADR-0021 documentation to mark acceptance criteria as completed.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch feat/adr-0021-completion-doc

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@coding-agent/docs/adr/0021-remote-session-and-workspace-operations-api.md`:
- Around line 357-371: Update the ADR header by changing the status line
"Status: Proposed" to "Status: Accepted" (or "Implemented") to reflect that all
acceptance criteria (the checked list including tests like
test_list_sessions_returns_visible_session_summaries,
test_cancel_session_turn_returns_cancelling_for_active_turn,
test_workspace_archive_manifest_reports_counts_bytes_and_changes, etc.) are
complete; ensure the single-line "Status:" field in
0021-remote-session-and-workspace-operations-api.md is updated and save the ADR.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: a55bd944-3c2f-4079-b092-91ab27958b60

📥 Commits

Reviewing files that changed from the base of the PR and between 75a0a96 and 8c112d6.

📒 Files selected for processing (1)
  • coding-agent/docs/adr/0021-remote-session-and-workspace-operations-api.md

Comment on lines +357 to 371
- [x] `test_list_sessions_returns_visible_session_summaries`
- [x] `test_list_sessions_requires_admin_scope_for_all_sessions`
- [x] `test_get_session_response_includes_status_and_workspace_summary`
- [x] `test_cancel_session_turn_returns_cancelling_for_active_turn`
- [x] `test_cancel_session_turn_exposes_cancelled_final_state`
- [x] `test_cancel_session_turn_rejects_non_owner`
- [x] `test_workspaces_list_requires_admin_scope`
- [x] `test_workspace_cleanup_requires_admin_scope`
- [x] `test_workspace_cleanup_skips_active_cloud_sessions`
- [x] `test_workspace_archive_manifest_reports_counts_bytes_and_changes`
- [x] `test_session_workspace_archive_endpoint_keeps_compatibility_alias`
- [x] `test_remote_run_uses_create_prompt_manifest_download_flow`
- [x] `test_remote_download_prompts_before_overwriting_local_workspace`
- [x] `uv run pytest tests/ui/test_http_server.py tests/ui/test_http_server_workspace_transfer.py tests/cli/test_remote_client.py tests/coding_agent/environment/ -k "session or workspace or remote or cancel or manifest or admin" -v`

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor | ⚡ Quick win

Align ADR state with completed acceptance criteria.

Lines 357–371 show all criteria completed, but the document still says Status: Proposed (Line 3). Please update the ADR status to reflect implemented/accepted state to avoid governance drift.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@coding-agent/docs/adr/0021-remote-session-and-workspace-operations-api.md`
around lines 357 - 371, Update the ADR header by changing the status line
"Status: Proposed" to "Status: Accepted" (or "Implemented") to reflect that all
acceptance criteria (the checked list including tests like
test_list_sessions_returns_visible_session_summaries,
test_cancel_session_turn_returns_cancelling_for_active_turn,
test_workspace_archive_manifest_reports_counts_bytes_and_changes, etc.) are
complete; ensure the single-line "Status:" field in
0021-remote-session-and-workspace-operations-api.md is updated and save the ADR.

@delete-cloud
delete-cloud merged commit 056d040 into main May 10, 2026
1 check passed
@delete-cloud
delete-cloud deleted the feat/adr-0021-completion-doc branch May 10, 2026 13:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant