Problem
When the target MotrixSim version has no exact docs tag, the skill checks the local cache only under the original target version before resolving a fallback.
For example:
- target runtime:
0.9.1.dev114058
- exact local directory:
~/.motrixsim/docs-md/0.9.1.dev114058 is absent
- closest compatible docs tag:
v0.9.0
- valid local cache:
~/.motrixsim/docs-md/0.9.0 already exists
The current workflow enters the GitHub fallback after the exact cache miss and clones/checks out v0.9.0 without re-checking the cache for the resolved fallback version.
Cause
The instructions use one ambiguous <version> value and combine two separate decisions:
- resolving the docs version for the target runtime
- choosing the source for that resolved docs version
The cache lookup happens before fallback resolution and is not repeated afterward.
Expected behavior
After resolving an exact or fallback docs tag, the agent must normalize it to a resolved docs version and validate ~/.motrixsim/docs-md/<resolved-docs-version> before cloning or fetching. It should clone only when that exact cache is missing or invalid.
Acceptance criteria
- Distinguish the target runtime version from the resolved docs version.
- Check the exact target-version cache first.
- Resolve an exact or closest compatible upstream tag without cloning the repository.
- Re-check the cache using the resolved docs version.
- Treat a cache as valid when both
api_md/index.md and mjcf_md/index.md exist.
- Clone or update the docs repository only when the resolved-version cache is missing or invalid.
- Document the
0.9.1.dev114058 to 0.9.0 case explicitly.
Problem
When the target MotrixSim version has no exact docs tag, the skill checks the local cache only under the original target version before resolving a fallback.
For example:
0.9.1.dev114058~/.motrixsim/docs-md/0.9.1.dev114058is absentv0.9.0~/.motrixsim/docs-md/0.9.0already existsThe current workflow enters the GitHub fallback after the exact cache miss and clones/checks out
v0.9.0without re-checking the cache for the resolved fallback version.Cause
The instructions use one ambiguous
<version>value and combine two separate decisions:The cache lookup happens before fallback resolution and is not repeated afterward.
Expected behavior
After resolving an exact or fallback docs tag, the agent must normalize it to a resolved docs version and validate
~/.motrixsim/docs-md/<resolved-docs-version>before cloning or fetching. It should clone only when that exact cache is missing or invalid.Acceptance criteria
api_md/index.mdandmjcf_md/index.mdexist.0.9.1.dev114058to0.9.0case explicitly.