Skip to content

docs: list copilot in remaining harness enumerations and document --add-dir#459

Merged
BunsDev merged 2 commits into
mainfrom
docs/458-harness-enum-sweep
Jul 22, 2026
Merged

docs: list copilot in remaining harness enumerations and document --add-dir#459
BunsDev merged 2 commits into
mainfrom
docs/458-harness-enum-sweep

Conversation

@BunsDev

@BunsDev BunsDev commented Jul 22, 2026

Copy link
Copy Markdown
Member

Context

Implementation

  • Approach: docs-only, in-place edits verified against the code: harness ids from crates/coven-cli/src/harness.rs built_in_harness_specs() (codex, claude, copilot), copilot install hint from the copilot spec, --add-dir behavior from main.rs:234-238.
  • User-visible behavior: docs only; no runtime change.
  • Compatibility notes: deliberately untouched — docs/PRODUCT-SPEC.md + docs/MVP-PLAN.md (historical/spec voice), docs/OPERATIONAL-MODEL.md:97 (the OpenClaw plugin really does map only codex/claude ids today — verified in packages/openclaw-coven), docs/es + docs/ru (translation sync is a separate pass).

Verification

  • cargo fmt --check — n/a (docs-only)
  • cargo clippy --workspace --all-targets -- -D warnings — n/a (docs-only)
  • cargo test --workspace --locked — n/a (docs-only)
  • python3 scripts/check-secrets.py — clean (current tree + history)
  • Additional manual checks: git diff --check clean; node --test scripts/onboarding-docs-test.mjs 13/13 pass; every replacement cross-checked against harness.rs/main.rs.

Risk and Rollback

  • Risk level: minimal (docs wording only).
  • Rollback plan: revert the single squash commit.

Agent Handoff

…dd-dir

Sweep the reference/topic docs that still claimed only Codex and Claude
Code where GitHub Copilot CLI is a shipped built-in harness, and add the
missing --add-dir row to the coven run reference.

Follow-up flagged in the bodies of merged PRs #453/#454/#457.

Closes #458

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Signed-off-by: Val Alexander <68980965+BunsDev@users.noreply.github.com>
Copilot AI review requested due to automatic review settings July 22, 2026 02:01

Copilot AI 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.

Pull request overview

Docs-only sweep to bring remaining reference/topic pages in line with the shipped built-in harness set (Codex, Claude Code, GitHub Copilot CLI) and to document coven run --add-dir.

Changes:

  • Update remaining “supported harness” enumerations to include GitHub Copilot CLI where appropriate.
  • Add --add-dir to the coven run reference (flags table + behavior description).
  • Refresh coven doctor and roadmap wording to reflect Copilot install/auth hints and recovery guidance.

Reviewed changes

Copilot reviewed 7 out of 7 changed files in this pull request and generated 2 comments.

Show a summary per file
File Description
docs/start/showcase.md Updates the showcase “today” card to include Copilot alongside Codex and Claude Code.
docs/ROADMAP.md Updates shipped-list bullets to include Copilot in built-in harness adapters, run examples, and recovery hints.
docs/reference/harness-adapters.md Updates the page summary to include Copilot in the harness list.
docs/reference/cli.md Updates the top-level CLI table row to include copilot in the harness ids list.
docs/reference/cli-run.md Documents --add-dir in the Common Flags table, including repeatability and fallback behavior.
docs/reference/cli-doctor.md Updates the “missing harness” section to include Copilot install/auth hints.
docs/concepts/features.md Updates the features card copy to include GitHub Copilot CLI in the “today” harness list.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread docs/reference/cli.md
| `coven status` | Ecosystem overview: daemon, sessions, familiars, skills, research, hub. Alias: `coven overview`. |
| `coven daemon start/status/restart/stop` | Manage the local daemon. |
| `coven run <harness> <prompt>` | Launch a project-scoped harness session. Current harness ids: `codex`, `claude`. |
| `coven run <harness> <prompt>` | Launch a project-scoped harness session. Current harness ids: `codex`, `claude`, `copilot`. |
@@ -1,5 +1,5 @@
---
summary: "The adapter shape Codex and Claude Code use today."
summary: "The adapter shape Codex, Claude Code, and GitHub Copilot CLI use today."
Copilot AI review requested due to automatic review settings July 22, 2026 03:04

Copilot AI 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.

Pull request overview

Copilot reviewed 7 out of 7 changed files in this pull request and generated 1 comment.

Comment thread docs/ROADMAP.md
- Versioned `coven.daemon.v1` API contract with named apiVersion, machine-readable capabilities, structured errors, and monotonic event cursors. See [`docs/API-CONTRACT.md`](/API-CONTRACT).
- Compatibility tests for the external OpenClaw bridge against versioned daemon responses.
- First-run recovery hints for missing Codex or Claude Code CLIs.
- First-run recovery hints for missing Codex, Claude Code, or GitHub Copilot CLIs.
@BunsDev
BunsDev merged commit da1f453 into main Jul 22, 2026
18 checks passed
@BunsDev
BunsDev deleted the docs/458-harness-enum-sweep branch July 22, 2026 03:17
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.

docs: reference pages still enumerate only codex/claude; coven run --add-dir undocumented

2 participants