@meridian-flow/mars-schema 0.33.7 → 0.34.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (450) hide show
  1. package/README.md +23 -8
  2. package/fixtures/check/agent-description-missing/expected.json +17 -0
  3. package/fixtures/{upgrade/agent-bom/expected.md → check/agent-description-missing/input/agents/coder.md} +2 -2
  4. package/fixtures/{prepare/legacy-changed/expected → check/agent-description-missing/input}/mars.toml +1 -1
  5. package/fixtures/check/agent-name-missing/expected.json +17 -0
  6. package/fixtures/check/agent-name-missing/input/agents/coder.md +4 -0
  7. package/fixtures/{prepare/legacy-definition-unchanged/expected → check/agent-name-missing/input}/mars.toml +1 -1
  8. package/fixtures/check/agent-no-frontmatter/expected.json +15 -0
  9. package/fixtures/check/agent-no-frontmatter/input/agents/coder.md +1 -0
  10. package/fixtures/{prepare/legacy-execution-non-string/expected → check/agent-no-frontmatter/input}/mars.toml +1 -1
  11. package/fixtures/check/claude-execution-fields-ignored/expected.json +33 -0
  12. package/fixtures/check/claude-execution-fields-ignored/input/agents/g.md +8 -0
  13. package/fixtures/check/claude-execution-fields-ignored/request.json +4 -0
  14. package/fixtures/check/claude-policy-override-dropped/expected.json +31 -0
  15. package/fixtures/check/claude-policy-override-dropped/input/agents/g.md +11 -0
  16. package/fixtures/check/claude-policy-override-dropped/request.json +4 -0
  17. package/fixtures/check/claude-repaired-value/expected.json +17 -0
  18. package/fixtures/check/claude-repaired-value/input/agents/g.md +5 -0
  19. package/fixtures/check/claude-repaired-value/request.json +4 -0
  20. package/fixtures/check/claude-restriction-entries-dropped/expected.json +18 -0
  21. package/fixtures/check/claude-restriction-entries-dropped/input/agents/g.md +10 -0
  22. package/fixtures/check/claude-restriction-entries-dropped/request.json +4 -0
  23. package/fixtures/check/claude-skill-name-differs/expected.json +43 -0
  24. package/fixtures/check/claude-skill-name-differs/input/skills/lint/SKILL.md +5 -0
  25. package/fixtures/check/claude-skill-name-differs/input/skills/ok/SKILL.md +5 -0
  26. package/fixtures/check/claude-skill-name-differs/request.json +4 -0
  27. package/fixtures/check/clean/expected.json +6 -0
  28. package/fixtures/check/clean/input/agents/coder.md +6 -0
  29. package/fixtures/check/clean/input/mars.toml +4 -0
  30. package/fixtures/check/clean/input/skills/review/SKILL.md +5 -0
  31. package/fixtures/check/dependency-ref-direct/deps/one/agents/helper.md +6 -0
  32. package/fixtures/check/dependency-ref-direct/deps/one/mars.toml +4 -0
  33. package/fixtures/check/dependency-ref-direct/expected.json +19 -0
  34. package/fixtures/check/dependency-ref-direct/input/agents/coder.md +5 -0
  35. package/fixtures/check/dependency-ref-direct/input/mars.toml +7 -0
  36. package/fixtures/check/dependency-ref-transitive/deps/one/mars.toml +7 -0
  37. package/fixtures/check/dependency-ref-transitive/deps/two/agents/helper.md +6 -0
  38. package/fixtures/check/dependency-ref-transitive/deps/two/mars.toml +4 -0
  39. package/fixtures/check/dependency-ref-transitive/expected.json +19 -0
  40. package/fixtures/check/dependency-ref-transitive/input/agents/coder.md +5 -0
  41. package/fixtures/check/dependency-ref-transitive/input/mars.toml +7 -0
  42. package/fixtures/check/duplicate-names/expected.json +97 -0
  43. package/fixtures/check/duplicate-names/input/agents/a.md +5 -0
  44. package/fixtures/check/duplicate-names/input/agents/b.md +5 -0
  45. package/fixtures/check/duplicate-names/input/agents/c.md +5 -0
  46. package/fixtures/check/duplicate-names/input/mars.toml +4 -0
  47. package/fixtures/check/duplicate-names/input/skills/s1/SKILL.md +5 -0
  48. package/fixtures/check/duplicate-names/input/skills/s2/SKILL.md +5 -0
  49. package/fixtures/check/duplicate-names/request.json +3 -0
  50. package/fixtures/check/duplicate-slug-different-names/expected.json +39 -0
  51. package/fixtures/check/duplicate-slug-different-names/input/mars.toml +4 -0
  52. package/fixtures/check/duplicate-slug-different-names/input/one/agents/x.md +5 -0
  53. package/fixtures/check/duplicate-slug-different-names/input/two/agents/x.md +5 -0
  54. package/fixtures/check/duplicate-slug-different-names/request.json +3 -0
  55. package/fixtures/check/duplicate-slug-same-name/expected.json +33 -0
  56. package/fixtures/check/duplicate-slug-same-name/input/mars.toml +4 -0
  57. package/fixtures/check/duplicate-slug-same-name/input/one/agents/x.md +5 -0
  58. package/fixtures/check/duplicate-slug-same-name/input/two/agents/x.md +5 -0
  59. package/fixtures/check/duplicate-slug-same-name/request.json +3 -0
  60. package/fixtures/check/filtered-entry-absent/deps/one/mars.toml +7 -0
  61. package/fixtures/check/filtered-entry-absent/deps/one/skills/near/SKILL.md +5 -0
  62. package/fixtures/check/filtered-entry-absent/expected.json +11 -0
  63. package/fixtures/check/filtered-entry-absent/input/agents/coder.md +6 -0
  64. package/fixtures/check/filtered-entry-absent/input/mars.toml +8 -0
  65. package/fixtures/check/filtered-entry-absent/request.json +3 -0
  66. package/fixtures/check/filtered-entry-present/deps/one/mars.toml +7 -0
  67. package/fixtures/check/filtered-entry-present/deps/one/skills/near/SKILL.md +5 -0
  68. package/fixtures/check/filtered-entry-present/deps/two/mars.toml +4 -0
  69. package/fixtures/check/filtered-entry-present/deps/two/skills/far/SKILL.md +5 -0
  70. package/fixtures/check/filtered-entry-present/expected.json +6 -0
  71. package/fixtures/check/filtered-entry-present/input/agents/coder.md +6 -0
  72. package/fixtures/check/filtered-entry-present/input/mars.toml +8 -0
  73. package/fixtures/check/filtered-entry-present/request.json +3 -0
  74. package/fixtures/check/foreign-dependency/deps/one/.claude-plugin/plugin.json +1 -0
  75. package/fixtures/check/foreign-dependency/deps/one/skills/lint/SKILL.md +5 -0
  76. package/fixtures/check/foreign-dependency/expected.json +6 -0
  77. package/fixtures/check/foreign-dependency/input/agents/coder.md +6 -0
  78. package/fixtures/check/foreign-dependency/input/mars.toml +7 -0
  79. package/fixtures/check/foreign-dependency/request.json +3 -0
  80. package/fixtures/check/invalid-root/expected.json +15 -0
  81. package/fixtures/check/invalid-root/input/agents/coder.md +5 -0
  82. package/fixtures/check/invalid-root/input/mars.toml +1 -0
  83. package/fixtures/check/invalid-root/request.json +3 -0
  84. package/fixtures/check/missing-dependency-no-refs/expected.json +11 -0
  85. package/fixtures/check/missing-dependency-no-refs/input/agents/coder.md +5 -0
  86. package/fixtures/check/missing-dependency-no-refs/input/mars.toml +7 -0
  87. package/fixtures/check/missing-dependency-no-refs/request.json +3 -0
  88. package/fixtures/check/name-mismatch/expected.json +27 -0
  89. package/fixtures/check/name-mismatch/input/agents/coder.md +5 -0
  90. package/fixtures/check/name-mismatch/input/mars.toml +4 -0
  91. package/fixtures/check/name-mismatch/input/skills/review/SKILL.md +5 -0
  92. package/fixtures/check/name-mismatch/request.json +3 -0
  93. package/fixtures/check/package-no-version/expected.json +18 -0
  94. package/fixtures/check/package-no-version/input/agents/coder.md +5 -0
  95. package/fixtures/{normalize/pre-v1-mars-permission/expected/mars-dep → check/package-no-version/input}/mars.toml +1 -1
  96. package/fixtures/check/package-no-version/request.json +3 -0
  97. package/fixtures/check/prepare-error-and-check-error-one-file/expected.json +51 -0
  98. package/fixtures/check/prepare-error-and-check-error-one-file/input/agents/a.md +6 -0
  99. package/fixtures/check/prepare-error-and-check-error-one-file/input/agents/b.md +5 -0
  100. package/fixtures/check/prepare-error-and-check-error-one-file/input/mars.toml +4 -0
  101. package/fixtures/check/prepare-error-and-check-error-one-file/request.json +3 -0
  102. package/fixtures/check/provider-ref-declared/deps/one/mars.toml +4 -0
  103. package/fixtures/check/provider-ref-declared/deps/one/skills/x/SKILL.md +5 -0
  104. package/fixtures/check/provider-ref-declared/expected.json +6 -0
  105. package/fixtures/check/provider-ref-declared/input/agents/coder.md +6 -0
  106. package/fixtures/check/provider-ref-declared/input/mars.toml +8 -0
  107. package/fixtures/check/provider-ref-declared/request.json +3 -0
  108. package/fixtures/check/provider-ref-no-dependencies/expected.json +17 -0
  109. package/fixtures/check/provider-ref-no-dependencies/input/agents/coder.md +6 -0
  110. package/fixtures/check/provider-ref-no-dependencies/input/mars.toml +4 -0
  111. package/fixtures/check/provider-ref-no-dependencies/request.json +3 -0
  112. package/fixtures/check/provider-ref-undeclared/deps/one/mars.toml +4 -0
  113. package/fixtures/check/provider-ref-undeclared/deps/one/skills/x/SKILL.md +5 -0
  114. package/fixtures/check/provider-ref-undeclared/expected.json +17 -0
  115. package/fixtures/check/provider-ref-undeclared/input/agents/coder.md +6 -0
  116. package/fixtures/check/provider-ref-undeclared/input/mars.toml +7 -0
  117. package/fixtures/check/provider-ref-undeclared/request.json +3 -0
  118. package/fixtures/check/provider-ref-unresolved-in-complete-graph/deps/one/mars.toml +7 -0
  119. package/fixtures/check/provider-ref-unresolved-in-complete-graph/deps/one/skills/near/SKILL.md +5 -0
  120. package/fixtures/check/provider-ref-unresolved-in-complete-graph/deps/two/mars.toml +4 -0
  121. package/fixtures/check/provider-ref-unresolved-in-complete-graph/deps/two/skills/far/SKILL.md +5 -0
  122. package/fixtures/check/provider-ref-unresolved-in-complete-graph/expected.json +17 -0
  123. package/fixtures/check/provider-ref-unresolved-in-complete-graph/input/agents/coder.md +6 -0
  124. package/fixtures/check/provider-ref-unresolved-in-complete-graph/input/mars.toml +7 -0
  125. package/fixtures/check/provider-ref-unresolved-in-complete-graph/request.json +3 -0
  126. package/fixtures/check/ref-external-no-package/expected.json +17 -0
  127. package/fixtures/check/ref-external-no-package/input/agents/coder.md +6 -0
  128. package/fixtures/check/ref-external-with-package/expected.json +17 -0
  129. package/fixtures/check/ref-external-with-package/input/agents/coder.md +6 -0
  130. package/fixtures/check/ref-external-with-package/input/mars.toml +4 -0
  131. package/fixtures/check/ref-external-with-package/request.json +3 -0
  132. package/fixtures/check/ref-through-transitive-dependency/deps/one/mars.toml +7 -0
  133. package/fixtures/check/ref-through-transitive-dependency/deps/one/skills/near/SKILL.md +5 -0
  134. package/fixtures/check/ref-through-transitive-dependency/deps/two/mars.toml +4 -0
  135. package/fixtures/check/ref-through-transitive-dependency/deps/two/skills/far/SKILL.md +5 -0
  136. package/fixtures/check/ref-through-transitive-dependency/expected.json +6 -0
  137. package/fixtures/check/ref-through-transitive-dependency/input/agents/coder.md +6 -0
  138. package/fixtures/check/ref-through-transitive-dependency/input/mars.toml +7 -0
  139. package/fixtures/check/ref-through-transitive-dependency/request.json +3 -0
  140. package/fixtures/check/ref-through-unreadable-dependency/deps/legacy/mars.toml +3 -0
  141. package/fixtures/check/ref-through-unreadable-dependency/deps/legacy/skills/near/SKILL.md +5 -0
  142. package/fixtures/check/ref-through-unreadable-dependency/expected.json +11 -0
  143. package/fixtures/check/ref-through-unreadable-dependency/input/agents/coder.md +6 -0
  144. package/fixtures/check/ref-through-unreadable-dependency/input/mars.toml +7 -0
  145. package/fixtures/check/ref-through-unreadable-dependency/request.json +3 -0
  146. package/fixtures/check/ref-unresolved-in-complete-graph/deps/one/mars.toml +7 -0
  147. package/fixtures/check/ref-unresolved-in-complete-graph/deps/one/skills/near/SKILL.md +5 -0
  148. package/fixtures/check/ref-unresolved-in-complete-graph/deps/two/mars.toml +4 -0
  149. package/fixtures/check/ref-unresolved-in-complete-graph/deps/two/skills/far/SKILL.md +5 -0
  150. package/fixtures/check/ref-unresolved-in-complete-graph/expected.json +17 -0
  151. package/fixtures/check/ref-unresolved-in-complete-graph/input/agents/coder.md +6 -0
  152. package/fixtures/check/ref-unresolved-in-complete-graph/input/mars.toml +7 -0
  153. package/fixtures/check/ref-unresolved-in-complete-graph/request.json +3 -0
  154. package/fixtures/check/ref-with-transitive-dependency-missing/deps/one/mars.toml +7 -0
  155. package/fixtures/check/ref-with-transitive-dependency-missing/deps/one/skills/near/SKILL.md +5 -0
  156. package/fixtures/check/ref-with-transitive-dependency-missing/expected.json +11 -0
  157. package/fixtures/check/ref-with-transitive-dependency-missing/input/agents/coder.md +6 -0
  158. package/fixtures/check/ref-with-transitive-dependency-missing/input/mars.toml +7 -0
  159. package/fixtures/check/ref-with-transitive-dependency-missing/request.json +3 -0
  160. package/fixtures/check/requirement-invalid/expected.json +27 -0
  161. package/fixtures/check/requirement-invalid/input/agents/coder.md +5 -0
  162. package/fixtures/check/requirement-invalid/input/mars.toml +6 -0
  163. package/fixtures/check/requirement-invalid/request.json +3 -0
  164. package/fixtures/check/root-skill-shadows-dependency/deps/dep/agents/coder.md +5 -0
  165. package/fixtures/check/root-skill-shadows-dependency/deps/dep/mars.toml +4 -0
  166. package/fixtures/check/root-skill-shadows-dependency/deps/dep/skills/x/SKILL.md +5 -0
  167. package/fixtures/check/root-skill-shadows-dependency/expected.json +23 -0
  168. package/fixtures/check/root-skill-shadows-dependency/input/agents/coder.md +5 -0
  169. package/fixtures/check/root-skill-shadows-dependency/input/mars.toml +7 -0
  170. package/fixtures/check/root-skill-shadows-dependency/input/skills/x/SKILL.md +5 -0
  171. package/fixtures/check/root-skill-shadows-dependency/request.json +3 -0
  172. package/fixtures/check/schema-1-ignores-target-facts/expected.json +6 -0
  173. package/fixtures/check/schema-1-ignores-target-facts/input/agents/coder.md +8 -0
  174. package/fixtures/check/schema-1-ignores-target-facts/input/mars.toml +5 -0
  175. package/fixtures/check/schema-1-ignores-target-facts/request.json +3 -0
  176. package/fixtures/check/schema-newer-root/expected.json +18 -0
  177. package/fixtures/check/schema-newer-root/input/agents/coder.md +5 -0
  178. package/fixtures/{prepare/legacy-definition-unchanged → check/schema-newer-root}/input/mars.toml +2 -1
  179. package/fixtures/check/schema-newer-root/request.json +3 -0
  180. package/fixtures/check/skill-folder-no-definition-at-all/expected.json +6 -0
  181. package/fixtures/check/skill-folder-no-definition-at-all/input/mars.toml +4 -0
  182. package/fixtures/check/skill-folder-no-definition-at-all/input/skills/notes/README.md +1 -0
  183. package/fixtures/check/skill-folder-no-definition-at-all/request.json +3 -0
  184. package/fixtures/check/skill-folder-no-skill-md/expected.json +23 -0
  185. package/fixtures/check/skill-folder-no-skill-md/input/mars.toml +4 -0
  186. package/fixtures/check/skill-folder-no-skill-md/input/skills/deep/inner/data.txt +1 -0
  187. package/fixtures/check/skill-folder-no-skill-md/input/skills/notes/README.md +1 -0
  188. package/fixtures/check/skill-folder-no-skill-md/input/skills/ok/SKILL.md +5 -0
  189. package/fixtures/check/skill-folder-no-skill-md/request.json +3 -0
  190. package/fixtures/check/skill-folder-under-deeper-container/expected.json +6 -0
  191. package/fixtures/check/skill-folder-under-deeper-container/input/agents/coder.md +5 -0
  192. package/fixtures/check/skill-folder-under-deeper-container/input/mars.toml +4 -0
  193. package/fixtures/check/skill-folder-under-deeper-container/input/vendor/skills/notes/README.md +1 -0
  194. package/fixtures/check/skill-folder-under-deeper-container/request.json +3 -0
  195. package/fixtures/check/two-dependencies-one-skill/deps/one/mars.toml +4 -0
  196. package/fixtures/check/two-dependencies-one-skill/deps/one/skills/x/SKILL.md +5 -0
  197. package/fixtures/check/two-dependencies-one-skill/deps/two/mars.toml +4 -0
  198. package/fixtures/check/two-dependencies-one-skill/deps/two/skills/x/SKILL.md +5 -0
  199. package/fixtures/check/two-dependencies-one-skill/expected.json +17 -0
  200. package/fixtures/check/two-dependencies-one-skill/input/agents/coder.md +5 -0
  201. package/fixtures/check/two-dependencies-one-skill/input/mars.toml +10 -0
  202. package/fixtures/check/two-dependencies-one-skill/request.json +3 -0
  203. package/fixtures/normalize/declared-mars-native/expected/native-dep/agents/planner.md +1 -2
  204. package/fixtures/normalize/declared-mars-native/inspection.json +1 -1
  205. package/fixtures/normalize/declared-mars-native/normalized.json +20 -26
  206. package/fixtures/normalize/invalid-plugin-json/normalized.json +2 -1
  207. package/fixtures/normalize/marketplace-strict-table/normalized.json +2 -1
  208. package/fixtures/normalize/mixed-claude-and-mars/expected/mixed-dep/skills/notes/SKILL.md +1 -1
  209. package/fixtures/normalize/mixed-claude-and-mars/normalized.json +13 -4
  210. package/fixtures/normalize/root-skill-fallback-name/normalized.json +1 -1
  211. package/fixtures/normalize/skill-translation/normalized.json +4 -12
  212. package/fixtures/prepare/authored-local-current/expected.json +1 -1
  213. package/fixtures/prepare/claude-reserved-keys/expected/agents/g.md +2 -4
  214. package/fixtures/prepare/claude-reserved-keys/expected.json +13 -22
  215. package/fixtures/prepare/invalid-toml/expected.json +2 -1
  216. package/fixtures/prepare/manifest-without-package/expected.json +2 -1
  217. package/fixtures/prepare/package-no-schema/expected.json +49 -0
  218. package/fixtures/prepare/package-no-schema/request.json +3 -0
  219. package/fixtures/prepare/{schema-1-meridian-keys → schema-1-retired-keys}/expected.json +29 -25
  220. package/fixtures/prepare/schema-1-retired-keys/request.json +1 -0
  221. package/fixtures/prepare/schema-newer/expected.json +2 -1
  222. package/fixtures/read/agent-approval-yolo/expected.json +2 -2
  223. package/fixtures/read/agent-network-invalid/expected.json +3 -3
  224. package/fixtures/read/{agent-removed-autocompact → agent-retired-autocompact}/expected.json +3 -3
  225. package/fixtures/read/{agent-removed-autocompact-pct → agent-retired-autocompact-pct}/expected.json +3 -3
  226. package/fixtures/read/{agent-removed-disallowed-tools → agent-retired-disallowed-tools}/expected.json +3 -3
  227. package/fixtures/read/{agent-removed-fanout → agent-retired-fanout}/expected.json +3 -3
  228. package/fixtures/read/{agent-removed-host-namespaces → agent-retired-host-namespaces}/expected.json +6 -6
  229. package/fixtures/read/{agent-removed-mcp-tools → agent-retired-mcp-tools}/expected.json +3 -3
  230. package/fixtures/read/{agent-removed-meridian-keys → agent-retired-meridian-keys}/expected.json +6 -6
  231. package/fixtures/read/{agent-removed-model-invocable → agent-retired-model-invocable}/expected.json +3 -3
  232. package/fixtures/read/{agent-removed-models → agent-retired-models}/expected.json +3 -3
  233. package/fixtures/read/{agent-removed-permission → agent-retired-permission}/expected.json +3 -3
  234. package/fixtures/read/{agent-removed-user-invocable → agent-retired-user-invocable}/expected.json +3 -3
  235. package/fixtures/read/manifest-missing-version/expected.json +1 -1
  236. package/fixtures/read/{manifest-removed-visibility → manifest-retired-visibility}/expected.json +3 -3
  237. package/fixtures/read/{skill-removed-allow-implicit-invocation → skill-retired-allow-implicit-invocation}/expected.json +3 -3
  238. package/fixtures/read/{skill-removed-allowed-tools → skill-retired-allowed-tools}/expected.json +3 -3
  239. package/fixtures/read/{skill-removed-disable-model-invocation → skill-retired-disable-model-invocation}/expected.json +3 -3
  240. package/fixtures/read/{skill-removed-disallowed-tools → skill-retired-disallowed-tools}/expected.json +3 -3
  241. package/fixtures/read/{skill-removed-invocation → skill-retired-invocation}/expected.json +3 -3
  242. package/fixtures/read/{skill-removed-model-invocable-alias → skill-retired-model-invocable-alias}/expected.json +3 -3
  243. package/fixtures/read/{skill-removed-tools → skill-retired-tools}/expected.json +3 -3
  244. package/fixtures/read/{skill-removed-type → skill-retired-type}/expected.json +3 -3
  245. package/fixtures/read/{skill-removed-user-invocable-alias → skill-retired-user-invocable-alias}/expected.json +3 -3
  246. package/fixtures/read/{skill-removed-when-to-use → skill-retired-when-to-use}/expected.json +3 -3
  247. package/index.d.ts +72 -17
  248. package/node/mars_schema_wasm.d.ts +9 -1
  249. package/node/mars_schema_wasm.js +30 -1
  250. package/node/mars_schema_wasm_bg.wasm +0 -0
  251. package/node/mars_schema_wasm_bg.wasm.d.ts +1 -0
  252. package/package.json +1 -1
  253. package/web/mars_schema_wasm.d.ts +10 -1
  254. package/web/mars_schema_wasm.js +29 -1
  255. package/web/mars_schema_wasm_bg.wasm +0 -0
  256. package/web/mars_schema_wasm_bg.wasm.d.ts +1 -0
  257. package/fixtures/normalize/pre-v1-mars-permission/expected/mars-dep/agents/reader.md +0 -12
  258. package/fixtures/normalize/pre-v1-mars-permission/input/agents/reader.md +0 -7
  259. package/fixtures/normalize/pre-v1-mars-permission/inspection.json +0 -21
  260. package/fixtures/normalize/pre-v1-mars-permission/normalized.json +0 -155
  261. package/fixtures/normalize/pre-v1-mars-permission/request.json +0 -3
  262. package/fixtures/normalize/pre-v1-mars-predicted/expected/legacy-dep/agents/old.md +0 -11
  263. package/fixtures/normalize/pre-v1-mars-predicted/expected/legacy-dep/mars.toml +0 -3
  264. package/fixtures/normalize/pre-v1-mars-predicted/expected/legacy-dep/skills/review/SKILL.md +0 -8
  265. package/fixtures/normalize/pre-v1-mars-predicted/input/agents/old.md +0 -10
  266. package/fixtures/normalize/pre-v1-mars-predicted/input/skills/review/SKILL.md +0 -7
  267. package/fixtures/normalize/pre-v1-mars-predicted/inspection.json +0 -28
  268. package/fixtures/normalize/pre-v1-mars-predicted/normalized.json +0 -222
  269. package/fixtures/normalize/pre-v1-mars-predicted/request.json +0 -3
  270. package/fixtures/prepare/authored-local-legacy/expected/agents/local.md +0 -6
  271. package/fixtures/prepare/authored-local-legacy/expected.json +0 -79
  272. package/fixtures/prepare/authored-local-legacy/input/agents/local.md +0 -6
  273. package/fixtures/prepare/legacy-agent-no-frontmatter/expected.json +0 -94
  274. package/fixtures/prepare/legacy-agent-no-frontmatter/input/agents/coder.md +0 -1
  275. package/fixtures/prepare/legacy-changed/expected/agents/coder.md +0 -6
  276. package/fixtures/prepare/legacy-changed/expected.json +0 -115
  277. package/fixtures/prepare/legacy-changed/input/agents/coder.md +0 -6
  278. package/fixtures/prepare/legacy-changed/input/mars.toml +0 -3
  279. package/fixtures/prepare/legacy-definition-unchanged/expected.json +0 -89
  280. package/fixtures/prepare/legacy-definition-unchanged/input/skills/steady/SKILL.md +0 -5
  281. package/fixtures/prepare/legacy-execution-non-string/expected/agents/runner.md +0 -5
  282. package/fixtures/prepare/legacy-execution-non-string/expected.json +0 -142
  283. package/fixtures/prepare/legacy-execution-non-string/input/agents/runner.md +0 -8
  284. package/fixtures/prepare/legacy-execution-non-string/input/mars.toml +0 -3
  285. package/fixtures/prepare/policy-override-bad-key/expected/agents/runner.md +0 -13
  286. package/fixtures/prepare/policy-override-bad-key/expected/mars.toml +0 -4
  287. package/fixtures/prepare/policy-override-bad-key/expected.json +0 -178
  288. package/fixtures/prepare/policy-override-bad-key/input/agents/runner.md +0 -10
  289. package/fixtures/prepare/policy-override-bad-key/input/mars.toml +0 -3
  290. package/fixtures/prepare/pre-v1-old-host-namespaces/expected/agents/demo.md +0 -15
  291. package/fixtures/prepare/pre-v1-old-host-namespaces/expected/mars.toml +0 -4
  292. package/fixtures/prepare/pre-v1-old-host-namespaces/expected.json +0 -135
  293. package/fixtures/prepare/pre-v1-old-host-namespaces/input/agents/demo.md +0 -15
  294. package/fixtures/prepare/pre-v1-old-host-namespaces/input/mars.toml +0 -3
  295. package/fixtures/prepare/schema-1-both-host-namespaces/expected/agents/demo.md +0 -14
  296. package/fixtures/prepare/schema-1-both-host-namespaces/expected.json +0 -160
  297. package/fixtures/prepare/schema-1-both-host-namespaces/input/agents/demo.md +0 -20
  298. package/fixtures/prepare/schema-1-both-host-namespaces/input/mars.toml +0 -4
  299. package/fixtures/prepare/schema-1-both-host-namespaces/request.json +0 -4
  300. package/fixtures/prepare/schema-1-meridian-keys/expected/agents/demo.md +0 -12
  301. package/fixtures/prepare/schema-1-meridian-keys/input/mars.toml +0 -4
  302. package/fixtures/prepare/schema-1-meridian-keys/request.json +0 -4
  303. package/fixtures/prepare/schema-1-old-host-namespaces/expected/agents/demo.md +0 -13
  304. package/fixtures/prepare/schema-1-old-host-namespaces/expected.json +0 -130
  305. package/fixtures/prepare/schema-1-old-host-namespaces/input/agents/demo.md +0 -13
  306. package/fixtures/prepare/schema-1-old-host-namespaces/input/mars.toml +0 -4
  307. package/fixtures/prepare/schema-1-old-host-namespaces/request.json +0 -4
  308. package/fixtures/upgrade/agent-approval-yolo/expected-diagnostics.json +0 -1
  309. package/fixtures/upgrade/agent-approval-yolo/expected.md +0 -4
  310. package/fixtures/upgrade/agent-approval-yolo/input.md +0 -4
  311. package/fixtures/upgrade/agent-approval-yolo/kind.txt +0 -1
  312. package/fixtures/upgrade/agent-bom/expected-diagnostics.json +0 -1
  313. package/fixtures/upgrade/agent-bom/input.md +0 -5
  314. package/fixtures/upgrade/agent-bom/kind.txt +0 -1
  315. package/fixtures/upgrade/agent-claude-keys-conflict/expected-diagnostics.json +0 -4
  316. package/fixtures/upgrade/agent-claude-keys-conflict/expected.md +0 -9
  317. package/fixtures/upgrade/agent-claude-keys-conflict/fully-rewritten.txt +0 -2
  318. package/fixtures/upgrade/agent-claude-keys-conflict/input.md +0 -11
  319. package/fixtures/upgrade/agent-claude-keys-conflict/kind.txt +0 -1
  320. package/fixtures/upgrade/agent-claude-keys-unmoved/expected-diagnostics.json +0 -3
  321. package/fixtures/upgrade/agent-claude-keys-unmoved/expected.md +0 -6
  322. package/fixtures/upgrade/agent-claude-keys-unmoved/input.md +0 -6
  323. package/fixtures/upgrade/agent-claude-keys-unmoved/kind.txt +0 -1
  324. package/fixtures/upgrade/agent-disallowed-tools/expected-diagnostics.json +0 -1
  325. package/fixtures/upgrade/agent-disallowed-tools/expected.md +0 -6
  326. package/fixtures/upgrade/agent-disallowed-tools/input.md +0 -5
  327. package/fixtures/upgrade/agent-disallowed-tools/kind.txt +0 -1
  328. package/fixtures/upgrade/agent-effort-adaptive/expected-diagnostics.json +0 -1
  329. package/fixtures/upgrade/agent-effort-adaptive/expected.md +0 -4
  330. package/fixtures/upgrade/agent-effort-adaptive/input.md +0 -4
  331. package/fixtures/upgrade/agent-effort-adaptive/kind.txt +0 -1
  332. package/fixtures/upgrade/agent-effort-disabled/expected-diagnostics.json +0 -1
  333. package/fixtures/upgrade/agent-effort-disabled/expected.md +0 -4
  334. package/fixtures/upgrade/agent-effort-disabled/input.md +0 -4
  335. package/fixtures/upgrade/agent-effort-disabled/kind.txt +0 -1
  336. package/fixtures/upgrade/agent-fallback-bom-no-trailing-newline/expected-diagnostics.json +0 -1
  337. package/fixtures/upgrade/agent-fallback-bom-no-trailing-newline/expected.md +0 -5
  338. package/fixtures/upgrade/agent-fallback-bom-no-trailing-newline/fully-rewritten.txt +0 -2
  339. package/fixtures/upgrade/agent-fallback-bom-no-trailing-newline/input.md +0 -4
  340. package/fixtures/upgrade/agent-fallback-bom-no-trailing-newline/kind.txt +0 -1
  341. package/fixtures/upgrade/agent-fallback-mixed-body/expected-diagnostics.json +0 -1
  342. package/fixtures/upgrade/agent-fallback-mixed-body/expected.md +0 -6
  343. package/fixtures/upgrade/agent-fallback-mixed-body/fully-rewritten.txt +0 -2
  344. package/fixtures/upgrade/agent-fallback-mixed-body/input.md +0 -5
  345. package/fixtures/upgrade/agent-fallback-mixed-body/kind.txt +0 -1
  346. package/fixtures/upgrade/agent-flow-top-level-fallback/expected-diagnostics.json +0 -1
  347. package/fixtures/upgrade/agent-flow-top-level-fallback/expected.md +0 -4
  348. package/fixtures/upgrade/agent-flow-top-level-fallback/fully-rewritten.txt +0 -1
  349. package/fixtures/upgrade/agent-flow-top-level-fallback/input.md +0 -3
  350. package/fixtures/upgrade/agent-flow-top-level-fallback/kind.txt +0 -1
  351. package/fixtures/upgrade/agent-invocability-aliases/expected-diagnostics.json +0 -1
  352. package/fixtures/upgrade/agent-invocability-aliases/expected.md +0 -5
  353. package/fixtures/upgrade/agent-invocability-aliases/input.md +0 -5
  354. package/fixtures/upgrade/agent-invocability-aliases/kind.txt +0 -1
  355. package/fixtures/upgrade/agent-meridian-keys/expected-diagnostics.json +0 -1
  356. package/fixtures/upgrade/agent-meridian-keys/expected.md +0 -11
  357. package/fixtures/upgrade/agent-meridian-keys/input.md +0 -10
  358. package/fixtures/upgrade/agent-meridian-keys/kind.txt +0 -1
  359. package/fixtures/upgrade/agent-minimal-comments/expected-diagnostics.json +0 -3
  360. package/fixtures/upgrade/agent-minimal-comments/expected.md +0 -8
  361. package/fixtures/upgrade/agent-minimal-comments/input.md +0 -10
  362. package/fixtures/upgrade/agent-minimal-comments/kind.txt +0 -1
  363. package/fixtures/upgrade/agent-model-policy-removed/expected-diagnostics.json +0 -5
  364. package/fixtures/upgrade/agent-model-policy-removed/expected.md +0 -8
  365. package/fixtures/upgrade/agent-model-policy-removed/input.md +0 -10
  366. package/fixtures/upgrade/agent-model-policy-removed/kind.txt +0 -1
  367. package/fixtures/upgrade/agent-network-both-spellings/expected-diagnostics.json +0 -1
  368. package/fixtures/upgrade/agent-network-both-spellings/expected.md +0 -11
  369. package/fixtures/upgrade/agent-network-both-spellings/input.md +0 -8
  370. package/fixtures/upgrade/agent-network-both-spellings/kind.txt +0 -1
  371. package/fixtures/upgrade/agent-network-kept/expected-diagnostics.json +0 -3
  372. package/fixtures/upgrade/agent-network-kept/expected.md +0 -10
  373. package/fixtures/upgrade/agent-network-kept/input.md +0 -8
  374. package/fixtures/upgrade/agent-network-kept/kind.txt +0 -1
  375. package/fixtures/upgrade/agent-permission/expected-diagnostics.json +0 -1
  376. package/fixtures/upgrade/agent-permission/expected.md +0 -8
  377. package/fixtures/upgrade/agent-permission/input.md +0 -7
  378. package/fixtures/upgrade/agent-permission/kind.txt +0 -1
  379. package/fixtures/upgrade/agent-removed-keys/expected-diagnostics.json +0 -7
  380. package/fixtures/upgrade/agent-removed-keys/expected.md +0 -3
  381. package/fixtures/upgrade/agent-removed-keys/input.md +0 -8
  382. package/fixtures/upgrade/agent-removed-keys/kind.txt +0 -1
  383. package/fixtures/upgrade/agent-tools-list/expected-diagnostics.json +0 -1
  384. package/fixtures/upgrade/agent-tools-list/expected.md +0 -7
  385. package/fixtures/upgrade/agent-tools-list/input.md +0 -5
  386. package/fixtures/upgrade/agent-tools-list/kind.txt +0 -1
  387. package/fixtures/upgrade/agent-unreadable-values/expected-diagnostics.json +0 -7
  388. package/fixtures/upgrade/agent-unreadable-values/expected.md +0 -9
  389. package/fixtures/upgrade/agent-unreadable-values/input.md +0 -13
  390. package/fixtures/upgrade/agent-unreadable-values/kind.txt +0 -1
  391. package/fixtures/upgrade/manifest-crlf/expected-diagnostics.json +0 -3
  392. package/fixtures/upgrade/manifest-crlf/expected.toml +0 -6
  393. package/fixtures/upgrade/manifest-crlf/input.toml +0 -6
  394. package/fixtures/upgrade/manifest-crlf/kind.txt +0 -1
  395. package/fixtures/upgrade/manifest-schema-visibility/expected-diagnostics.json +0 -3
  396. package/fixtures/upgrade/manifest-schema-visibility/expected.toml +0 -7
  397. package/fixtures/upgrade/manifest-schema-visibility/input.toml +0 -7
  398. package/fixtures/upgrade/manifest-schema-visibility/kind.txt +0 -1
  399. package/fixtures/upgrade/manifest-v1-idempotent/expected-diagnostics.json +0 -1
  400. package/fixtures/upgrade/manifest-v1-idempotent/expected.toml +0 -4
  401. package/fixtures/upgrade/manifest-v1-idempotent/input.toml +0 -4
  402. package/fixtures/upgrade/manifest-v1-idempotent/kind.txt +0 -1
  403. package/fixtures/upgrade/skill-crlf/expected-diagnostics.json +0 -3
  404. package/fixtures/upgrade/skill-crlf/expected.md +0 -7
  405. package/fixtures/upgrade/skill-crlf/input.md +0 -7
  406. package/fixtures/upgrade/skill-crlf/kind.txt +0 -1
  407. package/fixtures/upgrade/skill-tools-dropped/expected-diagnostics.json +0 -5
  408. package/fixtures/upgrade/skill-tools-dropped/expected.md +0 -3
  409. package/fixtures/upgrade/skill-tools-dropped/input.md +0 -6
  410. package/fixtures/upgrade/skill-tools-dropped/kind.txt +0 -1
  411. package/fixtures/upgrade/skill-type-when-to-use/expected-diagnostics.json +0 -1
  412. package/fixtures/upgrade/skill-type-when-to-use/expected.md +0 -10
  413. package/fixtures/upgrade/skill-type-when-to-use/input.md +0 -7
  414. package/fixtures/upgrade/skill-type-when-to-use/kind.txt +0 -1
  415. package/fixtures/upgrade/supporting-markdown/expected-diagnostics.json +0 -1
  416. package/fixtures/upgrade/supporting-markdown/expected.md +0 -4
  417. package/fixtures/upgrade/supporting-markdown/input.md +0 -4
  418. package/fixtures/upgrade/supporting-markdown/kind.txt +0 -1
  419. /package/fixtures/{prepare/legacy-agent-no-frontmatter → check/agent-description-missing}/request.json +0 -0
  420. /package/fixtures/{prepare/legacy-changed → check/agent-name-missing}/request.json +0 -0
  421. /package/fixtures/{prepare/legacy-definition-unchanged → check/agent-no-frontmatter}/request.json +0 -0
  422. /package/fixtures/{prepare/legacy-execution-non-string → check/clean}/request.json +0 -0
  423. /package/fixtures/{prepare/policy-override-bad-key → check/dependency-ref-direct}/request.json +0 -0
  424. /package/fixtures/{prepare/pre-v1-old-host-namespaces → check/dependency-ref-transitive}/request.json +0 -0
  425. /package/fixtures/{prepare/authored-local-legacy → check/ref-external-no-package}/request.json +0 -0
  426. /package/fixtures/prepare/{legacy-agent-no-frontmatter → package-no-schema}/input/mars.toml +0 -0
  427. /package/fixtures/prepare/{schema-1-meridian-keys → schema-1-retired-keys}/input/agents/demo.md +0 -0
  428. /package/fixtures/prepare/{legacy-agent-no-frontmatter/expected → schema-1-retired-keys/input}/mars.toml +0 -0
  429. /package/fixtures/read/{agent-removed-autocompact → agent-retired-autocompact}/agent.md +0 -0
  430. /package/fixtures/read/{agent-removed-autocompact-pct → agent-retired-autocompact-pct}/agent.md +0 -0
  431. /package/fixtures/read/{agent-removed-disallowed-tools → agent-retired-disallowed-tools}/agent.md +0 -0
  432. /package/fixtures/read/{agent-removed-fanout → agent-retired-fanout}/agent.md +0 -0
  433. /package/fixtures/read/{agent-removed-host-namespaces → agent-retired-host-namespaces}/agent.md +0 -0
  434. /package/fixtures/read/{agent-removed-mcp-tools → agent-retired-mcp-tools}/agent.md +0 -0
  435. /package/fixtures/read/{agent-removed-meridian-keys → agent-retired-meridian-keys}/agent.md +0 -0
  436. /package/fixtures/read/{agent-removed-model-invocable → agent-retired-model-invocable}/agent.md +0 -0
  437. /package/fixtures/read/{agent-removed-models → agent-retired-models}/agent.md +0 -0
  438. /package/fixtures/read/{agent-removed-permission → agent-retired-permission}/agent.md +0 -0
  439. /package/fixtures/read/{agent-removed-user-invocable → agent-retired-user-invocable}/agent.md +0 -0
  440. /package/fixtures/read/{manifest-removed-visibility → manifest-retired-visibility}/mars.toml +0 -0
  441. /package/fixtures/read/{skill-removed-allow-implicit-invocation → skill-retired-allow-implicit-invocation}/skill.md +0 -0
  442. /package/fixtures/read/{skill-removed-allowed-tools → skill-retired-allowed-tools}/skill.md +0 -0
  443. /package/fixtures/read/{skill-removed-disable-model-invocation → skill-retired-disable-model-invocation}/skill.md +0 -0
  444. /package/fixtures/read/{skill-removed-disallowed-tools → skill-retired-disallowed-tools}/skill.md +0 -0
  445. /package/fixtures/read/{skill-removed-invocation → skill-retired-invocation}/skill.md +0 -0
  446. /package/fixtures/read/{skill-removed-model-invocable-alias → skill-retired-model-invocable-alias}/skill.md +0 -0
  447. /package/fixtures/read/{skill-removed-tools → skill-retired-tools}/skill.md +0 -0
  448. /package/fixtures/read/{skill-removed-type → skill-retired-type}/skill.md +0 -0
  449. /package/fixtures/read/{skill-removed-user-invocable-alias → skill-retired-user-invocable-alias}/skill.md +0 -0
  450. /package/fixtures/read/{skill-removed-when-to-use → skill-retired-when-to-use}/skill.md +0 -0
package/README.md CHANGED
@@ -30,7 +30,8 @@ await init();
30
30
  | `rewriteBlock(frontmatter)` | The whole frontmatter block between the `---` fences for ordered `[key, value]` pairs. |
31
31
  | `vocabulary()` | The tool capabilities, their aliases, and the native tools of each host. |
32
32
  | `project(rules, host)` | Lowers an Agent's tool rules (a `capability` may be a whole key such as `bash(git *)`) onto a host with the code `mars sync` uses: the native names each action ends with, each rule's gap or stricter rule, and how the host handles `ask`. |
33
- | `prepare({files, context?, declaredDialect?, migrate?})` | Reads one root held in memory: classifies it, upgrades or translates it, and returns each definition's normalized bytes, typed reading and change record. `migrate` adds `mars migrate`'s repair: a removed Agent key whose replacement is a `harness-overrides` key moves there. Each Agent's `fields.tools` also holds the package's `[package.tools]` rules for keys the Agent does not name, with `origin: "package"`, as `mars sync` writes them. |
33
+ | `prepare({files, context?, declaredDialect?})` | Reads one root held in memory: classifies it, translates it if it is foreign, and returns each definition's normalized bytes, typed reading and change record. Each Agent's `fields.tools` also holds the package's `[package.tools]` rules for keys the Agent does not name, with `origin: "package"`, as `mars sync` writes them. |
34
+ | `check({files, context?, declaredDialect?, dependencies?})` | What is wrong with a package, per file: what `prepare` returns for each file plus the check's own findings (names, duplicates, skill refs, a skill folder with no `SKILL.md`, requirement syntax), each with a level. See [`check`](#check). |
34
35
  | `inspect({tree, hint?})` | Reports what a repository is: a marketplace's plugins, a plugin's or skill tree's items, the dialect and the evidence for it. |
35
36
  | `normalize({tree, source?, hint?, selection?})` | Turns a selection into schema v1 packages with a generated `mars.toml` and provenance. |
36
37
  | `satisfies(constraint, version)` | Whether a version meets a dependency entry's `version` (`^1.2`, `v2`, a bare `0.20` as `^0.20`, `latest`; a branch or commit pin is met by none). |
@@ -58,7 +59,7 @@ interface DefinitionRead<Fields> {
58
59
  - `fields` has the kebab-case spellings the file uses (`"model-invocable"`, `"harness-overrides"`), `xhigh` and `read-only` as written, and `null` or `[]` where the file sets nothing. `AgentFields`, `SkillFields` and `ManifestFields` are in `index.d.ts`; for `mars.toml`, `frontmatter` holds the pairs of the `[package]` table.
59
60
  - `diagnostics` carry a stable `code` (`field.removed`, `field.unknown`, `yaml.anchor`, ...), a `severity` of `error`, `warning` or `info`, and a `path` of keys and indexes into the file (`["model-policies", 0, "when"]`). Locate the diagnostic in the text with your own parser: `range` is for fence and YAML-syntax errors only, and no reader sets it yet. Errors do not stop the reading, so an editor can show the form and the problem together.
60
61
  - `frontmatter` omits a key whose value has no JSON form (a YAML tag, a non-string key, an integer beyond ±(2^53 − 1), a `__proto__` key) and reports it as `yaml.non-json-value` (`toml.non-json-value` for `mars.toml`). Mapping keys keep file order at every depth; JavaScript objects list integer-like keys such as `"1"` first.
61
- - An Agent whose first line is not `---` has no frontmatter, so every field takes its default and the file reads as the widest Agent. `read("agents/<slug>.md", text)` reports it as the error `frontmatter.missing`, with the defaults in `fields` and the whole file in `body`; `prepare` reports it the same way for a schema 1 package. A pre-v1 or foreign package's body-only Agent is not an error, and a skill with no frontmatter keeps its `skill.no-frontmatter` warning.
62
+ - An Agent whose first line is not `---` has no frontmatter, so every field takes its default and the file reads as the widest Agent. `read("agents/<slug>.md", text)` reports it as the error `frontmatter.missing`, with the defaults in `fields` and the whole file in `body`; `prepare` reports it the same way for a schema 1 package. A foreign package's body-only Agent is not an error, and a skill with no frontmatter keeps its `skill.no-frontmatter` warning.
62
63
  - Frontmatter has two limits, because the YAML scanners take time that grows with the square of the nesting depth and a server that reads untrusted files must not stall: a block over 64 KiB is `frontmatter.too-large`, and one that opens `[` or `{` more than 64 deep (counted over the raw text) is `frontmatter.too-deep`. Either gives `fields: null` and no other diagnostic. Real frontmatter is under 2 KiB and nests a few levels; the limits apply to `read`, `prepare` and `normalize` alike.
63
64
 
64
65
  ### Editing without losing the rest of the file
@@ -110,12 +111,26 @@ p.rules[0].status; // "known" | "absent" | "unknown" | "unscopable" | n
110
111
 
111
112
  ### `prepare`, `inspect`, `normalize`
112
113
 
113
- `prepare` is the single-root core. It classifies the root (`schema-1`, `mars-legacy`, `schema-newer`, a foreign dialect, `marketplace`, `invalid` or `empty`), selects definitions, upgrades a pre-v1 package or translates a foreign one, and reads each result. For each definition it returns the source and output paths, the normalized bytes, the typed reading, and a change record (`none`, `generated`, `edited` with the changed key paths, or `fully-rewritten`); payload files come back as source-to-output paths without bytes. Findings are keyed by source path in `diagnostics`; what preparing dropped, moved or repaired in each file (a pre-v1 upgrade's removals, a foreign translation's moves) is keyed the same way in `changes`, and a file counts as changed when its change record is not `none` or `generated`. `context` is `"package"` (the default), `"authored-local"` (a consumer project's `.mars-src`) or `"project"` (a project directory: a `mars.toml` with no `[package]` is consumer configuration, and the tree is read as authored content). A tree with no manifest is read as one dialect, Claude unless an Agent has a `permission` map or a `tools` map of booleans (OpenCode), and the keys only pre-v1 Mars defined are rewritten one by one whatever that dialect is, so they never change how the rest of the tree is read. A translated or upgraded definition is never refused: what schema v1 does not accept is moved under `harness-overrides.<dialect>` or dropped, except a key Mars lowers itself (`model`, `effort`, `tools`, `disallowed-tools`, `skills`, `mode`), which is never moved: a mapping loses only its invalid entries and a scalar is dropped. Losing a restriction is a change coded `field.restriction-lost` that names the agent; report these every time, since each leaves an agent less restricted than its file says. `fields.tools` of an Agent in `prepare`'s result is what `mars sync` installs: the package's `[package.tools]` rules for each key the Agent's own `tools:` does not name (two spellings of one key are one key) follow its own rules, marked `origin: "package"`; `normalized_bytes` stay the authored file's. `read` sees one file, so it never adds them. When the package's `mars.toml` has any error (an invalid `[package.tools]` entry included), each Agent's reading carries a `package-tools.unreadable` error: `mars sync` refuses that package and installs no Agent, so a consumer must not install it either. `prepare` is supported on its own, for reading one root without choosing items; `normalize` is `prepare` plus a selection, a generated `mars.toml` and provenance.
114
+ `prepare` is the single-root core. It classifies the root (`schema-1`, `schema-newer`, a foreign dialect, `marketplace`, `invalid` or `empty`), selects definitions, translates a foreign package, and reads each result. For each definition it returns the source and output paths, the normalized bytes, the typed reading, and a change record (`none`, `generated` or `fully-rewritten`); payload files come back as source-to-output paths without bytes. Findings are keyed by source path in `diagnostics`; what preparing dropped, moved or repaired in each file (a foreign translation's moves) is keyed the same way in `changes`, and a file counts as changed when its change record is not `none` or `generated`. `context` is `"package"` (the default), `"authored-local"` (a consumer project's `.mars-src`) or `"project"` (a project directory: a `mars.toml` with no `[package]` is consumer configuration, and the tree is read as authored content). A tree with no manifest is read as one dialect, Claude unless an Agent has a `permission` map or a `tools` map of booleans (OpenCode). A translated definition is never refused: what schema v1 does not accept is moved under `harness-overrides.<dialect>` or dropped, except a key Mars lowers itself (`model`, `effort`, `tools`, `disallowed-tools`, `skills`, `mode`), which is never moved: a mapping loses only its invalid entries and a scalar is dropped. Losing a restriction is a change coded `field.restriction-lost` that names the agent; report these every time, since each leaves an agent less restricted than its file says. `fields.tools` of an Agent in `prepare`'s result is what `mars sync` installs: the package's `[package.tools]` rules for each key the Agent's own `tools:` does not name (two spellings of one key are one key) follow its own rules, marked `origin: "package"`; `normalized_bytes` stay the authored file's. `read` sees one file, so it never adds them. When the package's `mars.toml` has any error (an invalid `[package.tools]` entry included), each Agent's reading carries a `package-tools.unreadable` error: `mars sync` refuses that package and installs no Agent, so a consumer must not install it either. The findings that cost the author nothing are `info`: `manifest.version-missing`, `skill.name-invalid`, `skill.description-too-long` and `frontmatter.repaired`. The warning `skill.name-mismatch` no longer exists: a name that differs from the file or folder is `definition.name-mismatch` (`info`) in `check`, for every dialect. `prepare` is supported on its own, for reading one root without choosing items; `normalize` is `prepare` plus a selection, a generated `mars.toml` and provenance.
114
115
 
115
- `inspect` reports what is in a repository before anything is chosen, and `normalize` builds the packages for a selection. A remote marketplace plugin is fetched by the caller: `inspect` the marketplace, fetch the entry's repository, then `inspect` or `normalize` the fetched tree with `hint.plugin` set to the entry.
116
+ `inspect` reports what is in a repository before anything is chosen, and `normalize` builds the packages for a selection. A remote marketplace plugin is fetched by the caller: `inspect` the marketplace, fetch the entry's repository, then `inspect` or `normalize` the fetched tree with `hint.plugin` set to the entry. For a root whose `kind` is `invalid`, `inspect` puts the manifest's findings under `diagnostics["mars.toml"]` (`manifest.schema-missing` for a package with no `schema`).
116
117
 
117
118
  Marketplace fields are untrusted input: a marketplace is third-party text, and an entry's repository and ref reach `git` as arguments. The crate checks them when it reads the entry, and an entry that fails comes back as `source.kind === "unsupported"` with a `reason` (and `refused` on the plugin), never as `remote`. A repository must be an `https://` or `ssh://` URL or a `user@host:path` address; a local repository (`file://`, an absolute path), `ext::`, `git://`, `http://` and the like are refused. A repository or ref that is empty, starts with `-` or holds whitespace or a control character is refused, and so is a `sha` that is not a full 40-character commit (it is never read as an unpinned checkout). A plugin name must be letters, digits, `-`, `_` and `.`, starting with a letter or digit (`is_plugin_name`); an entry that fails it is left out with `marketplace.plugin-name-invalid`, and a `plugin.json` name that fails it is ignored with `plugin.name-invalid`. The crate does not check that a repository exists, is reachable, or is on a host you allow: restricting hosts (GitHub only, say) is the caller's policy. The Claude rules (a plugin's `skills` list adds to the default folder, its `agents` list replaces it, commands are reported and not imported) are applied here; see [Dialect](https://github.com/haowjy/mars-agents/blob/main/docs/config/mars-toml.md#dialect).
118
119
 
120
+ ### `check`
121
+
122
+ `check` is what `mars check` reports about a package's own files, from the files and its dependencies. It prepares the root as `prepare` does, so it takes `prepare`'s input and returns a `Check`: `diagnostics` (by source path, `mars.toml` first, then lexical), `dependency_diagnostics`, `missing_dependencies` and `unreadable_dependencies`.
123
+
124
+ A level says what the author loses. **Error**: the file or package won't load or install (a duplicate `name`, a skill ref no package ships, a requirement that isn't one). **Warning**: something written won't take effect (a skill folder with no `SKILL.md`, a restriction translation dropped, a skill ref to a package the file doesn't declare). **Info**: nothing written is lost (an Agent with no `description`, a `name` that differs from the file name, a repaired value). Show errors and warnings by default and info on request. A file with an error is unusable; an error on `mars.toml` makes the whole package unusable.
125
+
126
+ Per path, `diagnostics` lists what `prepare` returns for the file and then the check's own findings, errors first, so the two never disagree: dropping the check's codes leaves `prepare`'s list. The check's own codes are `package.requirement`, `agent.description-missing`, `agent.name-missing`, `definition.name-mismatch`, `definition.duplicate-name`, `definition.duplicate-slug`, `selection.duplicate-slug`, `skill-ref.missing`, `skill-ref.provider`, `skill-ref.external`, `skill.no-definition`, and from a translated package `field.restriction-lost`, `field.execution-ignored` and `frontmatter.repaired`.
127
+
128
+ `dependencies` is the whole closure: every package reachable from the root through any `[dependencies]` entry, filtered or not, one entry per source, keyed by the name the declaring table gives it, each as `{ prepared: prepare(...) }` (the shape of `selectItems`' `packages`, `extra_items` included though `check` ignores it), as a plain object or a `Map`; an unknown key in an entry throws `input.invalid` either way. A dependency's own Agent that names a skill no package ships is `skill-ref.dependency` in `dependency_diagnostics`, by dependency and then the Agent's output path: it is not the root's to fix, so a Save that fails on errors in `diagnostics` leaves it out.
129
+
130
+ **`missing_dependencies` and `unreadable_dependencies` are not a verdict.** `missing_dependencies` lists the dependencies the call left out, with `declared_in` naming the package whose `mars.toml` declares each (`null` for the root). `unreadable_dependencies` has the same shape and lists the dependencies you passed that could not be read (their `prepared.selection.unreadable` is `true`: an invalid or newer-schema manifest); their own errors are in `prepare`'s result for them. While either is not empty no skill ref was judged, so a clean `diagnostics` does not mean the package passes: a missing dependency may be the one that ships the skill, and so may an unreadable one. Fetch or fix them and call again. A `prepare` result stored before 0.34.0 has no `unreadable` flag, so re-prepare stored dependencies.
131
+
132
+ `mars check` can fail a package this accepts: it also reports the `requires-mars` floor, hooks, plugin output, model aliases against `mars.lock`, what a harness target loses from an Agent, and an empty package, none of which depends on the files alone. See [`mars check`](https://github.com/haowjy/mars-agents/blob/main/docs/cli/commands.md#mars-check).
133
+
119
134
  ### Versions and selection
120
135
 
121
136
  The version functions are the rules `mars sync` applies, so a caller that resolves its own dependencies agrees with it. `selectVersion` is the whole decision for one package: it settles the constraints first (one pin wins; two pins, or a pin beside a range, throw), ignores tags that are not versions (`latest`, `nightly-2024`), treats `latest` and `null` constraints as any version, and with no version tag left answers `{untagged: true}`. Tags are strings (`v1.2.3` or `1.2.3`).
@@ -127,8 +142,8 @@ Every export throws an `Error` with a `code` (`MarsSchemaError` in `index.d.ts`)
127
142
  ```ts
128
143
  const result = selectItems({
129
144
  requests: [],
130
- root: { prepared: prepare({ files: rootFiles, migrate: true }) },
131
- packages: { base: { prepared: prepare({ files: baseFiles, migrate: true }) } },
145
+ root: { prepared: prepare({ files: rootFiles }) },
146
+ packages: { base: { prepared: prepare({ files: baseFiles }) } },
132
147
  });
133
148
  // result.items: [{package, kind, slug, path, required_by}], result.missing_skills, result.diagnostics
134
149
  ```
@@ -143,12 +158,12 @@ Each package's edges and `uses-providers` are read from `prepared.selection`, so
143
158
  |---|---|---|
144
159
  | `read` | the file, `expected.json` | the reading of one definition or manifest |
145
160
  | `emit` | `value.json`, `expected.txt` | the YAML for one value |
146
- | `upgrade` | `input.md`, `expected.md`, `expected-diagnostics.json` | the pre-v1 to v1 rewrite |
147
- | `prepare` | `input/`, `request.json`, `expected.json` | classifying and reading one root, and with `"migrate": true` the repair `mars migrate` writes back |
161
+ | `prepare` | `input/`, `request.json`, `expected.json` | classifying and reading one root |
148
162
  | `normalize` | `input/`, `request.json`, `inspection.json`, `normalized.json`, `expected/` | reading a foreign repository |
149
163
  | `vocabulary` | `expected.json` | the capabilities, aliases and native tools |
150
164
  | `project` | `request.json`, `expected.json` | `project` for one rule list on one host |
151
165
  | `version` | `input.json`, `expected.json` | `satisfies`, `satisfiesRequirement` and `selectVersion`, with the `code` of each refusal (the Rust leg also pins `parse-constraint` and `parse-tag`, which are not exported) |
166
+ | `check` | `input/`, `request.json`, optional `deps/<name>/`, `expected.json` | `check` over a root and its dependencies (each prepared first), the order of the paths included |
152
167
  | `selection` | `request.json`, `packages/` (or `packages_from`: a sibling case's), `expected.json` | `selectItems` over packages prepared from `packages/` |
153
168
 
154
169
  `node crates/mars-schema-wasm/run-fixtures.mjs` in the Mars repository runs every case against this package and compares results deeply, key order included. Run the same cases against the version you pin; a change to a pinned reader that changes a result is a change to the contract.
@@ -0,0 +1,17 @@
1
+ {
2
+ "diagnostics": {
3
+ "agents/coder.md": [
4
+ {
5
+ "code": "agent.description-missing",
6
+ "severity": "info",
7
+ "path": [
8
+ "description"
9
+ ],
10
+ "message": "agent `coder` has no `description`; Claude does not load an Agent without one"
11
+ }
12
+ ]
13
+ },
14
+ "dependency_diagnostics": {},
15
+ "missing_dependencies": [],
16
+ "unreadable_dependencies": []
17
+ }
@@ -1,4 +1,4 @@
1
- ---
1
+ ---
2
2
  name: coder
3
3
  ---
4
- body
4
+ Body.
@@ -1,4 +1,4 @@
1
1
  [package]
2
- name = "demo"
2
+ name = "p"
3
3
  version = "1.0.0"
4
4
  schema = 1
@@ -0,0 +1,17 @@
1
+ {
2
+ "diagnostics": {
3
+ "agents/coder.md": [
4
+ {
5
+ "code": "agent.name-missing",
6
+ "severity": "info",
7
+ "path": [
8
+ "name"
9
+ ],
10
+ "message": "agent `coder` has no `name`; the file name is used"
11
+ }
12
+ ]
13
+ },
14
+ "dependency_diagnostics": {},
15
+ "missing_dependencies": [],
16
+ "unreadable_dependencies": []
17
+ }
@@ -0,0 +1,4 @@
1
+ ---
2
+ description: An agent
3
+ ---
4
+ Body.
@@ -1,4 +1,4 @@
1
1
  [package]
2
- name = "demo"
2
+ name = "p"
3
3
  version = "1.0.0"
4
4
  schema = 1
@@ -0,0 +1,15 @@
1
+ {
2
+ "diagnostics": {
3
+ "agents/coder.md": [
4
+ {
5
+ "code": "frontmatter.missing",
6
+ "severity": "error",
7
+ "path": [],
8
+ "message": "an Agent's frontmatter must open with a first line that is exactly `---`; without it every field takes its default"
9
+ }
10
+ ]
11
+ },
12
+ "dependency_diagnostics": {},
13
+ "missing_dependencies": [],
14
+ "unreadable_dependencies": []
15
+ }
@@ -1,4 +1,4 @@
1
1
  [package]
2
- name = "demo"
2
+ name = "p"
3
3
  version = "1.0.0"
4
4
  schema = 1
@@ -0,0 +1,33 @@
1
+ {
2
+ "diagnostics": {
3
+ "agents/g.md": [
4
+ {
5
+ "code": "field.execution-ignored",
6
+ "severity": "warning",
7
+ "path": [
8
+ "mode"
9
+ ],
10
+ "message": "agent `g`: `mode: 3` ignored (not a string); use primary or subagent"
11
+ },
12
+ {
13
+ "code": "field.execution-ignored",
14
+ "severity": "warning",
15
+ "path": [
16
+ "effort"
17
+ ],
18
+ "message": "agent `g`: `effort: 2` ignored (not a string); use none, low, medium, high, xhigh or max"
19
+ },
20
+ {
21
+ "code": "field.execution-ignored",
22
+ "severity": "warning",
23
+ "path": [
24
+ "harness"
25
+ ],
26
+ "message": "agent `g`: `harness: 7` ignored (not a string); use claude, codex, opencode, cursor or pi"
27
+ }
28
+ ]
29
+ },
30
+ "dependency_diagnostics": {},
31
+ "missing_dependencies": [],
32
+ "unreadable_dependencies": []
33
+ }
@@ -0,0 +1,8 @@
1
+ ---
2
+ name: g
3
+ description: d
4
+ harness: 7
5
+ mode: 3
6
+ effort: 2
7
+ ---
8
+ Body.
@@ -0,0 +1,4 @@
1
+ {
2
+ "context": "package",
3
+ "declared_dialect": "claude"
4
+ }
@@ -0,0 +1,31 @@
1
+ {
2
+ "diagnostics": {
3
+ "agents/g.md": [
4
+ {
5
+ "code": "field.restriction-lost",
6
+ "severity": "warning",
7
+ "path": [
8
+ "model-policies",
9
+ 0,
10
+ "override",
11
+ "sandbox"
12
+ ],
13
+ "message": "agent `g` lost the restriction `model-policies.0.override.sandbox`: that override was dropped and the rest of the rule is kept. Schema v1 does not accept it (agent field `model-policies[0].override.sandbox` has invalid value `nonsense`; allowed: default, read-only, workspace-write, danger-full-access); use default, read-only, workspace-write or danger-full-access"
14
+ },
15
+ {
16
+ "code": "field.execution-ignored",
17
+ "severity": "warning",
18
+ "path": [
19
+ "model-policies",
20
+ 0,
21
+ "override",
22
+ "effort"
23
+ ],
24
+ "message": "agent `g`: `model-policies.0.override.effort: \"nonsense\"` ignored (not valid here); use none, low, medium, high, xhigh or max"
25
+ }
26
+ ]
27
+ },
28
+ "dependency_diagnostics": {},
29
+ "missing_dependencies": [],
30
+ "unreadable_dependencies": []
31
+ }
@@ -0,0 +1,11 @@
1
+ ---
2
+ name: g
3
+ description: d
4
+ model-policies:
5
+ - match:
6
+ alias: fast
7
+ override:
8
+ sandbox: nonsense
9
+ effort: nonsense
10
+ ---
11
+ Body.
@@ -0,0 +1,4 @@
1
+ {
2
+ "context": "package",
3
+ "declared_dialect": "claude"
4
+ }
@@ -0,0 +1,17 @@
1
+ {
2
+ "diagnostics": {
3
+ "agents/g.md": [
4
+ {
5
+ "code": "frontmatter.repaired",
6
+ "severity": "info",
7
+ "path": [
8
+ "description"
9
+ ],
10
+ "message": "the unquoted value of `description` is not valid plain YAML; it was quoted"
11
+ }
12
+ ]
13
+ },
14
+ "dependency_diagnostics": {},
15
+ "missing_dependencies": [],
16
+ "unreadable_dependencies": []
17
+ }
@@ -0,0 +1,5 @@
1
+ ---
2
+ name: g
3
+ description: Use when: the user asks
4
+ ---
5
+ Body.
@@ -0,0 +1,4 @@
1
+ {
2
+ "context": "package",
3
+ "declared_dialect": "claude"
4
+ }
@@ -0,0 +1,18 @@
1
+ {
2
+ "diagnostics": {
3
+ "agents/g.md": [
4
+ {
5
+ "code": "field.restriction-lost",
6
+ "severity": "warning",
7
+ "path": [
8
+ "network-deny",
9
+ 1
10
+ ],
11
+ "message": "agent `g` lost the restriction `network-deny: bad host`: that entry was dropped and the rest of `network-deny` is kept. Schema v1 does not accept it (agent field `network-deny[1]` has invalid value `bad host`; allowed: exact host, IP address, *.example.com (subdomains), or **.example.com (apex and subdomains); internationalized names must use punycode; URLs, ports, paths, numeric or hex-looking DNS endings, single-label wildcards, empty strings, and bare * are not allowed)"
12
+ }
13
+ ]
14
+ },
15
+ "dependency_diagnostics": {},
16
+ "missing_dependencies": [],
17
+ "unreadable_dependencies": []
18
+ }
@@ -0,0 +1,10 @@
1
+ ---
2
+ name: g
3
+ description: An agent
4
+ tools:
5
+ Read: allow
6
+ Bash: sometimes
7
+ Write: deny
8
+ network-deny: [blocked.example, "bad host"]
9
+ ---
10
+ Body.
@@ -0,0 +1,4 @@
1
+ {
2
+ "context": "package",
3
+ "declared_dialect": "claude"
4
+ }
@@ -0,0 +1,43 @@
1
+ {
2
+ "diagnostics": {
3
+ "skills/lint/SKILL.md": [
4
+ {
5
+ "code": "skill.name-invalid",
6
+ "severity": "info",
7
+ "path": [
8
+ "name"
9
+ ],
10
+ "message": "name `Linter Tool` has characters outside `a-z`, `0-9` and `-`"
11
+ },
12
+ {
13
+ "code": "skill.description-too-long",
14
+ "severity": "info",
15
+ "path": [
16
+ "description"
17
+ ],
18
+ "message": "description is over 1024 characters"
19
+ },
20
+ {
21
+ "code": "definition.name-mismatch",
22
+ "severity": "info",
23
+ "path": [
24
+ "name"
25
+ ],
26
+ "message": "skill folder `lint` doesn't match its `name` `Linter Tool`; Claude lists it as `Linter Tool`, but skill refs and install use the folder name `lint`"
27
+ }
28
+ ],
29
+ "skills/ok/SKILL.md": [
30
+ {
31
+ "code": "definition.name-mismatch",
32
+ "severity": "info",
33
+ "path": [
34
+ "name"
35
+ ],
36
+ "message": "skill folder `ok` doesn't match its `name` `renamed`; Claude lists it as `renamed`, but skill refs and install use the folder name `ok`"
37
+ }
38
+ ]
39
+ },
40
+ "dependency_diagnostics": {},
41
+ "missing_dependencies": [],
42
+ "unreadable_dependencies": []
43
+ }
@@ -0,0 +1,5 @@
1
+ ---
2
+ name: Linter Tool
3
+ description: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
4
+ ---
5
+ Body.
@@ -0,0 +1,5 @@
1
+ ---
2
+ name: renamed
3
+ description: A skill
4
+ ---
5
+ Body.
@@ -0,0 +1,4 @@
1
+ {
2
+ "context": "package",
3
+ "declared_dialect": "claude"
4
+ }
@@ -0,0 +1,6 @@
1
+ {
2
+ "diagnostics": {},
3
+ "dependency_diagnostics": {},
4
+ "missing_dependencies": [],
5
+ "unreadable_dependencies": []
6
+ }
@@ -0,0 +1,6 @@
1
+ ---
2
+ name: coder
3
+ description: An agent
4
+ skills: [review]
5
+ ---
6
+ Body.
@@ -0,0 +1,4 @@
1
+ [package]
2
+ name = "p"
3
+ version = "1.0.0"
4
+ schema = 1
@@ -0,0 +1,5 @@
1
+ ---
2
+ name: review
3
+ description: A skill
4
+ ---
5
+ Body.
@@ -0,0 +1,6 @@
1
+ ---
2
+ name: helper
3
+ description: An agent
4
+ skills: [nowhere]
5
+ ---
6
+ Body.
@@ -0,0 +1,4 @@
1
+ [package]
2
+ name = "one"
3
+ version = "1.0.0"
4
+ schema = 1
@@ -0,0 +1,19 @@
1
+ {
2
+ "diagnostics": {},
3
+ "dependency_diagnostics": {
4
+ "one": {
5
+ "agents/helper.md": [
6
+ {
7
+ "code": "skill-ref.dependency",
8
+ "severity": "error",
9
+ "path": [
10
+ "skills"
11
+ ],
12
+ "message": "agent `helper` of dependency `one` references skill `nowhere` not found in local package or dependencies\n searched: one\n hint: use a version of `one` that ships it, or add a dependency that does"
13
+ }
14
+ ]
15
+ }
16
+ },
17
+ "missing_dependencies": [],
18
+ "unreadable_dependencies": []
19
+ }
@@ -0,0 +1,5 @@
1
+ ---
2
+ name: coder
3
+ description: An agent
4
+ ---
5
+ Body.
@@ -0,0 +1,7 @@
1
+ [package]
2
+ name = "p"
3
+ version = "1.0.0"
4
+ schema = 1
5
+
6
+ [dependencies.one]
7
+ path = "../one"
@@ -0,0 +1,7 @@
1
+ [package]
2
+ name = "one"
3
+ version = "1.0.0"
4
+ schema = 1
5
+
6
+ [dependencies.two]
7
+ path = "../two"
@@ -0,0 +1,6 @@
1
+ ---
2
+ name: helper
3
+ description: An agent
4
+ skills: [nowhere]
5
+ ---
6
+ Body.
@@ -0,0 +1,4 @@
1
+ [package]
2
+ name = "two"
3
+ version = "1.0.0"
4
+ schema = 1
@@ -0,0 +1,19 @@
1
+ {
2
+ "diagnostics": {},
3
+ "dependency_diagnostics": {
4
+ "two": {
5
+ "agents/helper.md": [
6
+ {
7
+ "code": "skill-ref.dependency",
8
+ "severity": "error",
9
+ "path": [
10
+ "skills"
11
+ ],
12
+ "message": "agent `helper` of dependency `two` references skill `nowhere` not found in local package or dependencies\n searched: two, one\n hint: use a version of `two` that ships it, or add a dependency that does"
13
+ }
14
+ ]
15
+ }
16
+ },
17
+ "missing_dependencies": [],
18
+ "unreadable_dependencies": []
19
+ }
@@ -0,0 +1,5 @@
1
+ ---
2
+ name: coder
3
+ description: An agent
4
+ ---
5
+ Body.
@@ -0,0 +1,7 @@
1
+ [package]
2
+ name = "p"
3
+ version = "1.0.0"
4
+ schema = 1
5
+
6
+ [dependencies.one]
7
+ path = "../one"