Skip to content

#963 Rename the harness id to rovo and qualify the frontmatter key - #1199

Merged
williamthorsen merged 6 commits into
mainfrom
963
Aug 5, 2026
Merged

#963 Rename the harness id to rovo and qualify the frontmatter key#1199
williamthorsen merged 6 commits into
mainfrom
963

Conversation

@williamthorsen

@williamthorsen williamthorsen commented Aug 5, 2026

Copy link
Copy Markdown
Owner

What

Renames the internal ID for the Rovo Dev harness from rovodev to rovo. --harness rovo replaces --harness rovodev in every command.

Separately, renames the harnesses frontmatter key (which narrows a skill to particular harnesses) to supported-harnesses: to avoid confusion.

Why

A forthcoming declaration-file key will also be called harnesses:, selecting which harnesses a sync run targets rather than narrowing an artifact. Same word, different files, different meaning, and a reader who confuses the two gets no error — only the wrong deployment.

Details

🎉 Features

  • 🚨 Breaking: --harness rovo replaces --harness rovodev. No alias is accepted for the retired value. The --harness help text, its usage line, and the invalid-harness error now derive their accepted-value list from one source, so the next harness reaches all three without an edit.
  • 🚨 Breaking: Skill frontmatter declares supported-harnesses: in place of harnesses:. The deploy-time read and the library list delivery column resolve the key through a single shared constant, and the strip that keeps the key out of a deployed skill is anchored to the qualified name.
  • 🚨 Breaking: A content root renames subagents/_data/rovodev.yaml to rovo.yaml, and guidance/_harnesses/rovodev/ to guidance/_harnesses/rovo/.
  • The harness id is independent of the install directory.
  • Reporting a retired bare harnesses: key from validate is deferred to Report the retired harnesses: frontmatter key from validate #1197.

🧪 Tests

  • The frontmatter-key strip and the harness guidance install are both covered. The guidance check reads the harness table rather than a fixed list, so a content directory named for a harness id cannot drift from that id unnoticed.
  • Test fixtures and their helpers name rovo, except where rovodev is the currently used path.

📚 Documentation

  • AGENTS.md, the package README, the partials README, and the content specification name rovo and supported-harnesses:. The Rovo Dev hook-configuration example carries the new flag value.

Closes #963

`--harness rovo` replaces `--harness rovodev` in every command, and the help text and error message list the new value.

Re-run `codeassembly install` after upgrading: session-lifecycle hook entries in `~/.rovodev/config.yml` carry the harness id, and stale entries stop relaying events until they are rewritten.

Content authors rename the subagent frontmatter overlay `subagents/_data/rovodev.yaml` to `rovo.yaml`.

CodeAssembly's name for the harness is now independent of the directory it installs into, which stays `~/.rovodev` until Atlassian's own rename lands.
Skill frontmatter declares `supported-harnesses:` in place of `harnesses:`; content authors rename the key in any skill that narrows itself to specific harnesses.

The bare `harnesses:` now belongs to declaration files alone, where it chooses which harnesses a sync run targets.
Guidance, package documentation, and skill reference tables name the `rovo` harness and the `supported-harnesses:` frontmatter key. No reference to `--harness rovodev` or the bare `harnesses:` frontmatter key remains outside the released changelog.
Renames the harness guidance directory to `guidance/_harnesses/rovo/`, completing the rename of the harness id.

A content root carrying `guidance/_harnesses/rovodev/` must rename it to `guidance/_harnesses/rovo/`. `codeassembly install` resolves the directory by harness id, and delivers no harness guidance when it finds none there.
Covers two behaviors the harness-vocabulary rename left unguarded: that a skill's `supported-harnesses:` frontmatter key is stripped from the deployed skill, and that every harness receives its guidance file when the full library installs.

The guidance check tracks the harness table rather than a fixed list, so a new harness is covered without an edit.
Spells the harness `rovo` in the remaining test fixtures and in the helper that seeds its home directory, leaving `rovodev` in code only where it names Atlassian's own `.rovodev` path.
@williamthorsen williamthorsen added breaking Breaking API change or removal of functionality feature Added or improved external functionality labels Aug 5, 2026
@github-actions

github-actions Bot commented Aug 5, 2026

Copy link
Copy Markdown

Dependency audit

Production dependency audit passed.

@williamthorsen
williamthorsen marked this pull request as ready for review August 5, 2026 12:41
@williamthorsen williamthorsen self-assigned this Aug 5, 2026
@williamthorsen
williamthorsen merged commit cb47091 into main Aug 5, 2026
3 checks passed
@williamthorsen
williamthorsen deleted the 963 branch August 5, 2026 12:49
williamthorsen added a commit that referenced this pull request Aug 7, 2026
…ssembly-mcp-v0.2.4 codeassembly-v0.6.0

codeassembly-v0.6.0
- #794 feat: Guide kb-add note placement with the store's declared taxonomy (#1223)
- #1111 feat: Declare which harnesses sync targets (#1221)
- #1214 feat: Allow an artifact to belong to more than one collection (#1219)
- #1186 drop!: Dissolve `common-mistakes` into its consumers' guidance (#1217)
- deps: Upgrade all deps to latest version
- #1203 fix: Bar acceptance-criteria revision prompts to genuine conflicts (#1212)
- #1196 feat: Add the .kb/taxonomy.yaml format with drift reporting and back-fill (#1210)
- #1165 feat: Make a vetted subset of the library declarable (#1207)
- #1197 feat: Report the retired `harnesses:` frontmatter key from `validate` (#1204)
- #963 feat!: Rename the harness id to rovo and qualify the frontmatter key (#1199)
- #1188 drop!: Retire the bundled Bitbucket inline-comment script (#1198)
- #1187 feat: Gate the boolean prefix on a test and add the tail rule it rests on (#1195)

factory-v0.2.4
- deps: Upgrade all deps to latest version
- deps: Upgrade all deps to latest version
- #1209 refactor: Clear factory's remaining lint violations and retire both deferral lists (#1216)
- #1208 refactor: Clear the visualizations lint violations and retire six rule deferrals (#1213)

kb-v0.4.0
- #794 feat: Guide kb-add note placement with the store's declared taxonomy (#1223)
- #1196 feat: Add the .kb/taxonomy.yaml format with drift reporting and back-fill (#1210)

codeassembly-lifecycle-v0.3.0
- #963 feat!: Rename the harness id to rovo and qualify the frontmatter key (#1199)

codeassembly-mcp-v0.2.4
- #1206 refactor: Retire fleet's lint deferrals (#1211)
- #1200 tooling: Retire mcp's lint deferrals and prune the dead root entries (#1205)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

breaking Breaking API change or removal of functionality feature Added or improved external functionality scope:agents

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Settle the harness vocabulary: rename rovodev to rovo and qualify the frontmatter key

1 participant