You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Depends on: #289, which decides what the first statement should say. Worth doing last.
What happens
Eight published statements contradict the implementation. They are not cosmetic: they lead a crate author to build the wrong integration, which is how dial9 ended up serving skills from a crate nobody depends on. Note the eight statements span twelve file locations.
crate-authors/supporting-your-crate.md offers a chained reference's version field as the way to version skills separately from the library, and reference/plugin-definition.md presents the field with no caveat. That version is discarded (Symposium & Dial9: A plugin reference's declared version is accepted and ignored #289). The worked example also places the reference in a crate most projects do not declare, so copying it reproduces the bug.
reference/plugin-definition.md and crate-authors/authoring-a-plugin.md say hooks, MCP servers and subcommands declared in a crate manifest are not yet dispatched. All three dispatch, and there is a test for each. Only custom predicate definitions remain unwired.
reference/plugin-definition.md and crate-authors/supporting-your-crate.md document a ten-hop limit on reference chains. No such limit exists; termination comes from tracking what has already been loaded.
crate-authors/supporting-your-crate.md says a cycle "stops and warns". The skip is silent. (reference/plugin-definition.md says only "with cycle detection", which is true.)
crate-authors/supporting-your-crate.md and reference/plugin-definition.md say deduplication is by crate name plus version. Neither of the two dedups uses the version.
reference/cargo-agents-sync.md says sync registers both global and project hooks. It registers one, per the configured scope.
design/important-flows.md says the consent prompt and the use / search / status commands are not implemented. All four ship.
Separately, [subcommand.<name>] has no reference documentation at all, though the crate-author guide sends readers to the reference for the full schema.
How to see it
Each is a pair to compare; no commands needed beyond opening the two sides. For statements 3 and 4 the quickest check is that nothing in the plugin-resolution code implements a depth limit or logs a skip, and design/module-structure.md already describes the real behaviour correctly, so the reference pages and the design chapter disagree with each other.
Done when
All eight statements either match the code or are removed, across all twelve locations.
Part of #294.
Depends on: #289, which decides what the first statement should say. Worth doing last.
What happens
Eight published statements contradict the implementation. They are not cosmetic: they lead a crate author to build the wrong integration, which is how dial9 ended up serving skills from a crate nobody depends on. Note the eight statements span twelve file locations.
crate-authors/supporting-your-crate.mdoffers a chained reference's version field as the way to version skills separately from the library, andreference/plugin-definition.mdpresents the field with no caveat. That version is discarded (Symposium & Dial9: A plugin reference's declared version is accepted and ignored #289). The worked example also places the reference in a crate most projects do not declare, so copying it reproduces the bug.reference/plugin-definition.mdandcrate-authors/authoring-a-plugin.mdsay hooks, MCP servers and subcommands declared in a crate manifest are not yet dispatched. All three dispatch, and there is a test for each. Only custom predicate definitions remain unwired.reference/plugin-definition.mdandcrate-authors/supporting-your-crate.mddocument a ten-hop limit on reference chains. No such limit exists; termination comes from tracking what has already been loaded.crate-authors/supporting-your-crate.mdsays a cycle "stops and warns". The skip is silent. (reference/plugin-definition.mdsays only "with cycle detection", which is true.)crate-authors/supporting-your-crate.mdandreference/plugin-definition.mdsay deduplication is by crate name plus version. Neither of the two dedups uses the version.workspace-skills.mdsays a member crate's skills install, once published, for projects depending on the crate. That needs either the user's consent or a registry entry naming it, since dependencies are not a trust root. (Related: Symposium & Dial9: A disabled plugin installs anyway, and the status output disagrees with what happened #290.)reference/cargo-agents-sync.mdsayssyncregisters both global and project hooks. It registers one, per the configured scope.design/important-flows.mdsays the consent prompt and theuse/search/statuscommands are not implemented. All four ship.Separately,
[subcommand.<name>]has no reference documentation at all, though the crate-author guide sends readers to the reference for the full schema.How to see it
Each is a pair to compare; no commands needed beyond opening the two sides. For statements 3 and 4 the quickest check is that nothing in the plugin-resolution code implements a depth limit or logs a skip, and
design/module-structure.mdalready describes the real behaviour correctly, so the reference pages and the design chapter disagree with each other.Done when
[subcommand.<name>]appears in the reference.