@dxos/deus 0.0.0-stage → 0.0.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 (201) hide show
  1. package/LICENSE +105 -0
  2. package/README.md +24 -2
  3. package/bin/deus.ts +42 -0
  4. package/dist/lib/chunk-blocks.mjs +151 -0
  5. package/dist/lib/chunk-blocks.mjs.map +1 -0
  6. package/dist/lib/chunk-check.mjs +452 -0
  7. package/dist/lib/chunk-check.mjs.map +1 -0
  8. package/dist/lib/chunk-completion.mjs +112 -0
  9. package/dist/lib/chunk-completion.mjs.map +1 -0
  10. package/dist/lib/chunk-extension.mjs +396 -0
  11. package/dist/lib/chunk-extension.mjs.map +1 -0
  12. package/dist/lib/chunk-parse.mjs +21 -0
  13. package/dist/lib/chunk-parse.mjs.map +1 -0
  14. package/dist/lib/cli.mjs +946 -0
  15. package/dist/lib/cli.mjs.map +1 -0
  16. package/dist/lib/extension.mjs +4 -0
  17. package/dist/lib/index.mjs +6 -0
  18. package/dist/lib/parse.mjs +4 -0
  19. package/dist/lib/review.mjs +260 -0
  20. package/dist/lib/review.mjs.map +1 -0
  21. package/dist/lib/spec-index.mjs +28 -0
  22. package/dist/lib/spec-index.mjs.map +1 -0
  23. package/dist/types/bin/deus.d.ts +3 -0
  24. package/dist/types/bin/deus.d.ts.map +1 -0
  25. package/dist/types/src/cli/__fixtures__/review/plugin-deps/dx.config.d.ts +8 -0
  26. package/dist/types/src/cli/__fixtures__/review/plugin-deps/dx.config.d.ts.map +1 -0
  27. package/dist/types/src/cli/__fixtures__/review/plugin-deps-diverged/dx.config.d.ts +8 -0
  28. package/dist/types/src/cli/__fixtures__/review/plugin-deps-diverged/dx.config.d.ts.map +1 -0
  29. package/dist/types/src/cli/__fixtures__/review/plugin-deps-empty/dx.config.d.ts +7 -0
  30. package/dist/types/src/cli/__fixtures__/review/plugin-deps-empty/dx.config.d.ts.map +1 -0
  31. package/dist/types/src/cli/__fixtures__/review/plugin-deps-mismatch/dx.config.d.ts +8 -0
  32. package/dist/types/src/cli/__fixtures__/review/plugin-deps-mismatch/dx.config.d.ts.map +1 -0
  33. package/dist/types/src/cli/__fixtures__/review/plugin-deps-noplugin/dx.config.d.ts +5 -0
  34. package/dist/types/src/cli/__fixtures__/review/plugin-deps-noplugin/dx.config.d.ts.map +1 -0
  35. package/dist/types/src/cli/changelog.d.ts +25 -0
  36. package/dist/types/src/cli/changelog.d.ts.map +1 -0
  37. package/dist/types/src/cli/cli.test.d.ts +2 -0
  38. package/dist/types/src/cli/cli.test.d.ts.map +1 -0
  39. package/dist/types/src/cli/errors.d.ts +183 -0
  40. package/dist/types/src/cli/errors.d.ts.map +1 -0
  41. package/dist/types/src/cli/features.d.ts +58 -0
  42. package/dist/types/src/cli/features.d.ts.map +1 -0
  43. package/dist/types/src/cli/git.d.ts +8 -0
  44. package/dist/types/src/cli/git.d.ts.map +1 -0
  45. package/dist/types/src/cli/index.d.ts +12 -0
  46. package/dist/types/src/cli/index.d.ts.map +1 -0
  47. package/dist/types/src/cli/lint.d.ts +17 -0
  48. package/dist/types/src/cli/lint.d.ts.map +1 -0
  49. package/dist/types/src/cli/qa-lint.d.ts +40 -0
  50. package/dist/types/src/cli/qa-lint.d.ts.map +1 -0
  51. package/dist/types/src/cli/qa.d.ts +86 -0
  52. package/dist/types/src/cli/qa.d.ts.map +1 -0
  53. package/dist/types/src/cli/review.d.ts +38 -0
  54. package/dist/types/src/cli/review.d.ts.map +1 -0
  55. package/dist/types/src/cli/spec-index.d.ts +17 -0
  56. package/dist/types/src/cli/spec-index.d.ts.map +1 -0
  57. package/dist/types/src/extension/blocks.d.ts +65 -0
  58. package/dist/types/src/extension/blocks.d.ts.map +1 -0
  59. package/dist/types/src/extension/check.d.ts +99 -0
  60. package/dist/types/src/extension/check.d.ts.map +1 -0
  61. package/dist/types/src/extension/check.test.d.ts +2 -0
  62. package/dist/types/src/extension/check.test.d.ts.map +1 -0
  63. package/dist/types/src/extension/code.d.ts +7 -0
  64. package/dist/types/src/extension/code.d.ts.map +1 -0
  65. package/dist/types/src/extension/complete.d.ts +6 -0
  66. package/dist/types/src/extension/complete.d.ts.map +1 -0
  67. package/dist/types/src/extension/completion.d.ts +10 -0
  68. package/dist/types/src/extension/completion.d.ts.map +1 -0
  69. package/dist/types/src/extension/constants.d.ts +6 -0
  70. package/dist/types/src/extension/constants.d.ts.map +1 -0
  71. package/dist/types/src/extension/fences.d.ts +10 -0
  72. package/dist/types/src/extension/fences.d.ts.map +1 -0
  73. package/dist/types/src/extension/gen/mdl.d.ts +3 -0
  74. package/dist/types/src/extension/gen/mdl.d.ts.map +1 -0
  75. package/dist/types/src/extension/gen/mdl.terms.d.ts +2 -0
  76. package/dist/types/src/extension/gen/mdl.terms.d.ts.map +1 -0
  77. package/dist/types/src/extension/index.d.ts +8 -0
  78. package/dist/types/src/extension/index.d.ts.map +1 -0
  79. package/dist/types/src/extension/language.d.ts +20 -0
  80. package/dist/types/src/extension/language.d.ts.map +1 -0
  81. package/dist/types/src/extension/lint.d.ts +8 -0
  82. package/dist/types/src/extension/lint.d.ts.map +1 -0
  83. package/dist/types/src/extension/parse.d.ts +6 -0
  84. package/dist/types/src/extension/parse.d.ts.map +1 -0
  85. package/dist/types/src/extension/parser.test.d.ts +2 -0
  86. package/dist/types/src/extension/parser.test.d.ts.map +1 -0
  87. package/dist/types/src/extension/refs.d.ts +32 -0
  88. package/dist/types/src/extension/refs.d.ts.map +1 -0
  89. package/dist/types/src/extension/refs.test.d.ts +2 -0
  90. package/dist/types/src/extension/refs.test.d.ts.map +1 -0
  91. package/dist/types/src/extension/syntax.d.ts +12 -0
  92. package/dist/types/src/extension/syntax.d.ts.map +1 -0
  93. package/dist/types/src/index.d.ts +3 -0
  94. package/dist/types/src/index.d.ts.map +1 -0
  95. package/dist/types/src/review/fields.d.ts +9 -0
  96. package/dist/types/src/review/fields.d.ts.map +1 -0
  97. package/dist/types/src/review/index.d.ts +5 -0
  98. package/dist/types/src/review/index.d.ts.map +1 -0
  99. package/dist/types/src/review/review.d.ts +70 -0
  100. package/dist/types/src/review/review.d.ts.map +1 -0
  101. package/dist/types/src/review/review.test.d.ts +2 -0
  102. package/dist/types/src/review/review.test.d.ts.map +1 -0
  103. package/dist/types/src/review/source-key.d.ts +35 -0
  104. package/dist/types/src/review/source-key.d.ts.map +1 -0
  105. package/dist/types/src/review/symbol.d.ts +17 -0
  106. package/dist/types/src/review/symbol.d.ts.map +1 -0
  107. package/dist/types/src/review/symbol.test.d.ts +2 -0
  108. package/dist/types/src/review/symbol.test.d.ts.map +1 -0
  109. package/dist/types/src/spec-index/index.d.ts +3 -0
  110. package/dist/types/src/spec-index/index.d.ts.map +1 -0
  111. package/dist/types/src/spec-index/parse.d.ts +11 -0
  112. package/dist/types/src/spec-index/parse.d.ts.map +1 -0
  113. package/dist/types/src/spec-index/spec-index.d.ts +21 -0
  114. package/dist/types/src/spec-index/spec-index.d.ts.map +1 -0
  115. package/dist/types/src/spec-index/spec-index.test.d.ts +2 -0
  116. package/dist/types/src/spec-index/spec-index.test.d.ts.map +1 -0
  117. package/dist/types/tsconfig.tsbuildinfo +1 -0
  118. package/docs/DESIGN.md +561 -0
  119. package/docs/IDIOMS.md +265 -0
  120. package/lang/PLUGIN-.template.mdl +115 -0
  121. package/lang/app.mdl +200 -0
  122. package/lang/changelog.mdl +184 -0
  123. package/lang/core.mdl +203 -0
  124. package/lang/examples/chess-1.mdl +149 -0
  125. package/lang/examples/chess-2.mdl +203 -0
  126. package/lang/examples/chess-3.mdl +231 -0
  127. package/lang/features.mdl +92 -0
  128. package/lang/plugin.mdl +59 -0
  129. package/lang/qa.mdl +383 -0
  130. package/lang/review.mdl +103 -0
  131. package/lang/sql.mdl +72 -0
  132. package/package.json +74 -3
  133. package/src/cli/__fixtures__/bad-decision.mdl +13 -0
  134. package/src/cli/__fixtures__/features/CYCLE.mdl +25 -0
  135. package/src/cli/__fixtures__/features/FEATURES.mdl +47 -0
  136. package/src/cli/__fixtures__/features/SPEC.mdl +22 -0
  137. package/src/cli/__fixtures__/features/SPEC.review.mdl +32 -0
  138. package/src/cli/__fixtures__/features/TASKS.md +5 -0
  139. package/src/cli/__fixtures__/lint-refs/SPEC.mdl +7 -0
  140. package/src/cli/__fixtures__/lint-refs/SPEC.review.mdl +7 -0
  141. package/src/cli/__fixtures__/qa-lint/packages/plugins/plugin-risky/PLUGIN.mdl +29 -0
  142. package/src/cli/__fixtures__/qa-list/plugin-sample/spec/PLUGIN.mdl +51 -0
  143. package/src/cli/__fixtures__/review/SPEC.mdl +23 -0
  144. package/src/cli/__fixtures__/review/SPEC.review.mdl +26 -0
  145. package/src/cli/__fixtures__/review/plugin-deps/PLUGIN.mdl +9 -0
  146. package/src/cli/__fixtures__/review/plugin-deps/PLUGIN.review.mdl +13 -0
  147. package/src/cli/__fixtures__/review/plugin-deps/dx.config.ts +10 -0
  148. package/src/cli/__fixtures__/review/plugin-deps-diverged/PLUGIN.mdl +9 -0
  149. package/src/cli/__fixtures__/review/plugin-deps-diverged/PLUGIN.review.mdl +14 -0
  150. package/src/cli/__fixtures__/review/plugin-deps-diverged/dx.config.ts +10 -0
  151. package/src/cli/__fixtures__/review/plugin-deps-empty/PLUGIN.mdl +9 -0
  152. package/src/cli/__fixtures__/review/plugin-deps-empty/PLUGIN.review.mdl +13 -0
  153. package/src/cli/__fixtures__/review/plugin-deps-empty/dx.config.ts +9 -0
  154. package/src/cli/__fixtures__/review/plugin-deps-mismatch/PLUGIN.mdl +9 -0
  155. package/src/cli/__fixtures__/review/plugin-deps-mismatch/PLUGIN.review.mdl +13 -0
  156. package/src/cli/__fixtures__/review/plugin-deps-mismatch/dx.config.ts +10 -0
  157. package/src/cli/__fixtures__/review/plugin-deps-noplugin/PLUGIN.mdl +9 -0
  158. package/src/cli/__fixtures__/review/plugin-deps-noplugin/PLUGIN.review.mdl +13 -0
  159. package/src/cli/__fixtures__/review/plugin-deps-noplugin/dx.config.ts +7 -0
  160. package/src/cli/changelog.ts +122 -0
  161. package/src/cli/cli.test.ts +359 -0
  162. package/src/cli/errors.ts +23 -0
  163. package/src/cli/features.ts +320 -0
  164. package/src/cli/git.ts +35 -0
  165. package/src/cli/index.ts +27 -0
  166. package/src/cli/lint.ts +75 -0
  167. package/src/cli/qa-lint.ts +206 -0
  168. package/src/cli/qa.ts +300 -0
  169. package/src/cli/review.ts +359 -0
  170. package/src/cli/spec-index.ts +54 -0
  171. package/src/extension/blocks.ts +169 -0
  172. package/src/extension/check.test.ts +629 -0
  173. package/src/extension/check.ts +552 -0
  174. package/src/extension/code.ts +99 -0
  175. package/src/extension/complete.ts +34 -0
  176. package/src/extension/completion.ts +64 -0
  177. package/src/extension/constants.ts +28 -0
  178. package/src/extension/fences.ts +270 -0
  179. package/src/extension/gen/mdl.terms.ts +16 -0
  180. package/src/extension/gen/mdl.ts +16 -0
  181. package/src/extension/index.ts +25 -0
  182. package/src/extension/language.ts +33 -0
  183. package/src/extension/lint.ts +19 -0
  184. package/src/extension/mdl.grammar +60 -0
  185. package/src/extension/parse.ts +31 -0
  186. package/src/extension/parser.test.ts +248 -0
  187. package/src/extension/refs.test.ts +95 -0
  188. package/src/extension/refs.ts +94 -0
  189. package/src/extension/syntax.ts +25 -0
  190. package/src/index.ts +6 -0
  191. package/src/review/fields.ts +31 -0
  192. package/src/review/index.ts +8 -0
  193. package/src/review/review.test.ts +111 -0
  194. package/src/review/review.ts +184 -0
  195. package/src/review/source-key.ts +63 -0
  196. package/src/review/symbol.test.ts +47 -0
  197. package/src/review/symbol.ts +96 -0
  198. package/src/spec-index/index.ts +6 -0
  199. package/src/spec-index/parse.ts +22 -0
  200. package/src/spec-index/spec-index.test.ts +56 -0
  201. package/src/spec-index/spec-index.ts +49 -0
@@ -0,0 +1,25 @@
1
+ ---
2
+ id: org.dxos.fixture.features.cycle
3
+ name: Cyclic feature map fixture
4
+ version: 0.1.0
5
+ ---
6
+
7
+ ## Extensions
8
+
9
+ | Term | URI |
10
+ | --------- | -------------------------- |
11
+ | `feature` | `org.dxos.mdl.feature@1.0` |
12
+
13
+ ```mdl
14
+ feature first: First
15
+ status: planned
16
+ specs: [packages/reflect/deus/src/cli/__fixtures__/features/SPEC.mdl#F-1]
17
+ depends: [second]
18
+ ```
19
+
20
+ ```mdl
21
+ feature second: Second
22
+ status: planned
23
+ specs: [packages/reflect/deus/src/cli/__fixtures__/features/SPEC.mdl#F-1]
24
+ depends: [first]
25
+ ```
@@ -0,0 +1,47 @@
1
+ ---
2
+ id: org.dxos.fixture.features.map
3
+ name: Feature map fixture
4
+ version: 0.1.0
5
+ ---
6
+
7
+ A fixture feature map for `deus features`.
8
+
9
+ ## Extensions
10
+
11
+ | Term | URI |
12
+ | --------- | -------------------------- |
13
+ | `feature` | `org.dxos.mdl.feature@1.0` |
14
+
15
+ ## Features
16
+
17
+ ```mdl
18
+ feature listing: Listing
19
+ status: operational
20
+ specs: [packages/reflect/deus/src/cli/__fixtures__/features/SPEC.mdl#F-1]
21
+ ```
22
+
23
+ ```mdl
24
+ feature greeting: Greeting
25
+ status: operational
26
+ specs: [packages/reflect/deus/src/cli/__fixtures__/features/SPEC.mdl#Greet]
27
+ depends: [listing]
28
+ ```
29
+
30
+ ```mdl
31
+ feature listing-next: Export, planned
32
+ status: planned
33
+ specs: [packages/reflect/deus/src/cli/__fixtures__/features/SPEC.mdl#F-2]
34
+ ```
35
+
36
+ ```mdl
37
+ feature export: Export, claimed in progress
38
+ status: in-progress
39
+ specs: [packages/reflect/deus/src/cli/__fixtures__/features/SPEC.mdl#F-2.1]
40
+ depends: [nobody]
41
+ ```
42
+
43
+ ```mdl
44
+ feature ghost: Cites nothing that exists
45
+ status: shiny
46
+ specs: [packages/reflect/deus/src/cli/__fixtures__/features/SPEC.mdl#F-9, packages/reflect/deus/src/cli/__fixtures__/features/NOPE.mdl]
47
+ ```
@@ -0,0 +1,22 @@
1
+ ---
2
+ id: org.dxos.fixture.features
3
+ name: Features fixture
4
+ version: 0.1.0
5
+ ---
6
+
7
+ A fixture spec for `deus features`.
8
+
9
+ ```mdl
10
+ feat F-1: Listing
11
+ req F-1.1: The CLI lists items.
12
+ req F-1.2: The CLI filters items.
13
+ ```
14
+
15
+ ```mdl
16
+ feat F-2: Export
17
+ req F-2.1: The CLI exports items as JSON.
18
+ ```
19
+
20
+ ```mdl
21
+ op Greet: Says hello
22
+ ```
@@ -0,0 +1,32 @@
1
+ ---
2
+ spec: github:dxos/dxos/packages/reflect/deus/src/cli/__fixtures__/features/SPEC.mdl
3
+ commit: 0000000000000000000000000000000000000000
4
+ date: 2026-10-27
5
+ by: agent:claude-code
6
+ ---
7
+
8
+ # Review: Features fixture
9
+
10
+ ## Verdicts
11
+
12
+ ```mdl
13
+ verdict F-1.1: Lists.
14
+ status: done
15
+ ```
16
+
17
+ ```mdl
18
+ verdict F-1.2: Filters.
19
+ status: done
20
+ ```
21
+
22
+ ```mdl
23
+ verdict F-2.1: Nothing exports.
24
+ status: missing
25
+ note: No exporter exists. Searched the CLI.
26
+ ```
27
+
28
+ ```mdl
29
+ verdict Greet: Greets, untested.
30
+ status: untested
31
+ note: No test says hello.
32
+ ```
@@ -0,0 +1,5 @@
1
+ # Tasks
2
+
3
+ ## listing-next: Export
4
+
5
+ - [ ] F-2.1: Export items as JSON.
@@ -0,0 +1,7 @@
1
+ ---
2
+ id: org.dxos.fixture.lint-refs
3
+ name: Lint refs
4
+ version: 0.1.0
5
+ ---
6
+
7
+ See org.dxos.fixture.nope#X.
@@ -0,0 +1,7 @@
1
+ ---
2
+ id: org.dxos.fixture.lint-refs
3
+ name: Lint refs
4
+ version: 0.1.0
5
+ ---
6
+
7
+ See org.dxos.fixture.nope#X.
@@ -0,0 +1,29 @@
1
+ ---
2
+ id: org.dxos.plugin.risky
3
+ name: Risky
4
+ version: 0.1.0
5
+ ---
6
+
7
+ A fixture spec with one unbound reference and one unsafe teardown, for `deus qa lint`.
8
+
9
+ ## QA
10
+
11
+ ```mdl
12
+ test QA-1: Uses names it never binds
13
+ given:
14
+ - space: an empty space
15
+ steps:
16
+ - do: open $given.space
17
+ - do: rename $given.document to $title
18
+ capture: title
19
+ - do: delete $orphan
20
+ ```
21
+
22
+ ```mdl
23
+ test QA-2: Removes whatever comes first
24
+ steps:
25
+ - do: create a document
26
+ after:
27
+ - do: remove the document
28
+ invoke: removeObjects(db.query(Filter.type(Document)).objects[0])
29
+ ```
@@ -0,0 +1,51 @@
1
+ ---
2
+ id: org.dxos.plugin.sample
3
+ name: Sample
4
+ version: 0.1.0
5
+ ---
6
+
7
+ A fixture spec for the `deus` CLI tests.
8
+
9
+ ## Features
10
+
11
+ ```mdl
12
+ feat F-1: Greeting
13
+ req F-1.1: The plugin shows a greeting.
14
+ ```
15
+
16
+ ## QA
17
+
18
+ ```mdl
19
+ test QA-1: Shows the greeting
20
+ covers: [F-1.1]
21
+ tags: [smoke]
22
+ before:
23
+ - do: open a space
24
+ steps:
25
+ - do: open the sample article
26
+ - name: check the greeting
27
+ after:
28
+ - do: close the space
29
+ ```
30
+
31
+ ```mdl
32
+ test QA-2: Hides the greeting
33
+ status: verified
34
+ steps:
35
+ - do: toggle the greeting off
36
+ ```
37
+
38
+ ```mdl
39
+ suite smoke: Smoke tests
40
+ tags: [nightly]
41
+ tests: [QA-1, QA-2, other:QA-9]
42
+ ```
43
+
44
+ ## Changelog
45
+
46
+ ```mdl
47
+ decision D-1: The sample plugin shows a greeting.
48
+ date: 2026-10-23
49
+ by: user:dmaretskyi
50
+ affects: [F-1]
51
+ ```
@@ -0,0 +1,23 @@
1
+ ---
2
+ id: org.dxos.fixture.review
3
+ name: Review fixture
4
+ version: 0.1.0
5
+ ---
6
+
7
+ A fixture spec for `deus review`.
8
+
9
+ ```mdl
10
+ feat F-1: Listing
11
+ req F-1.1: The CLI lists review items.
12
+ req F-1.2: The CLI checks reviews.
13
+ ```
14
+
15
+ ```mdl
16
+ op Greet: Says hello
17
+ ```
18
+
19
+ ```mdl
20
+ test QA-1: Lists the items
21
+ steps:
22
+ - do: run the command
23
+ ```
@@ -0,0 +1,26 @@
1
+ ---
2
+ spec: github:dxos/dxos/packages/reflect/deus/src/cli/__fixtures__/review/SPEC.mdl
3
+ commit: 0000000000000000000000000000000000000000
4
+ date: 2026-10-23
5
+ by: agent:claude-code
6
+ ---
7
+
8
+ ```mdl
9
+ verdict F-1.1: Listed
10
+ status: done
11
+ evidence: [github:dxos/dxos/packages/reflect/deus/src/cli/review.ts#reviewItems]
12
+ tests: [github:dxos/dxos/packages/reflect/deus/src/cli/cli.test.ts]
13
+ ```
14
+
15
+ ```mdl
16
+ verdict F-1.2: Checked
17
+ status: partial
18
+ evidence: [github:dxos/dxos/packages/reflect/deus/src/cli/review.ts#noSuchSymbol]
19
+ ```
20
+
21
+ ```mdl
22
+ verdict Greet: Greets
23
+ status: shiny
24
+ note: Not a status.
25
+ evidence: [github:dxos/dxos/../outside.ts]
26
+ ```
@@ -0,0 +1,9 @@
1
+ ---
2
+ id: org.example.plugin.sample
3
+ ---
4
+
5
+ ```mdl
6
+ plugin SamplePlugin: Sample.
7
+ id: org.example.plugin.sample
8
+ dependsOn: [org.example.plugin.b, org.example.plugin.a]
9
+ ```
@@ -0,0 +1,13 @@
1
+ ---
2
+ spec: github:dxos/dxos/packages/reflect/deus/src/cli/__fixtures__/review/plugin-deps/PLUGIN.mdl
3
+ commit: 0000000000000000000000000000000000000000
4
+ date: 2026-10-27
5
+ by: agent:claude-code
6
+ ---
7
+
8
+ ```mdl
9
+ verdict SamplePlugin: Sample
10
+ status: done
11
+ evidence: [github:dxos/dxos/packages/reflect/deus/src/cli/review.ts#checkReview]
12
+ tests: [github:dxos/dxos/packages/reflect/deus/src/cli/cli.test.ts]
13
+ ```
@@ -0,0 +1,10 @@
1
+ //
2
+ // Copyright 2026 DXOS.org
3
+ //
4
+
5
+ export default {
6
+ plugin: {
7
+ id: 'org.example.plugin.sample',
8
+ dependsOn: ['org.example.plugin.a', 'org.example.plugin.b'],
9
+ },
10
+ };
@@ -0,0 +1,9 @@
1
+ ---
2
+ id: org.example.plugin.sample
3
+ ---
4
+
5
+ ```mdl
6
+ plugin SamplePlugin: Sample.
7
+ id: org.example.plugin.sample
8
+ dependsOn: [org.example.plugin.a]
9
+ ```
@@ -0,0 +1,14 @@
1
+ ---
2
+ spec: github:dxos/dxos/packages/reflect/deus/src/cli/__fixtures__/review/plugin-deps-diverged/PLUGIN.mdl
3
+ commit: 0000000000000000000000000000000000000000
4
+ date: 2026-10-27
5
+ by: agent:claude-code
6
+ ---
7
+
8
+ ```mdl
9
+ verdict SamplePlugin: Sample
10
+ status: diverged
11
+ note: The spec lists one dependency; dx.config.ts lists two.
12
+ evidence: [github:dxos/dxos/packages/reflect/deus/src/cli/review.ts#checkReview]
13
+ tests: [github:dxos/dxos/packages/reflect/deus/src/cli/cli.test.ts]
14
+ ```
@@ -0,0 +1,10 @@
1
+ //
2
+ // Copyright 2026 DXOS.org
3
+ //
4
+
5
+ export default {
6
+ plugin: {
7
+ id: 'org.example.plugin.sample',
8
+ dependsOn: ['org.example.plugin.a', 'org.example.plugin.b'],
9
+ },
10
+ };
@@ -0,0 +1,9 @@
1
+ ---
2
+ id: org.example.plugin.sample
3
+ ---
4
+
5
+ ```mdl
6
+ plugin SamplePlugin: Sample.
7
+ id: org.example.plugin.sample
8
+ dependsOn: [org.example.plugin.a]
9
+ ```
@@ -0,0 +1,13 @@
1
+ ---
2
+ spec: github:dxos/dxos/packages/reflect/deus/src/cli/__fixtures__/review/plugin-deps-empty/PLUGIN.mdl
3
+ commit: 0000000000000000000000000000000000000000
4
+ date: 2026-10-27
5
+ by: agent:claude-code
6
+ ---
7
+
8
+ ```mdl
9
+ verdict SamplePlugin: Sample
10
+ status: done
11
+ evidence: [github:dxos/dxos/packages/reflect/deus/src/cli/review.ts#checkReview]
12
+ tests: [github:dxos/dxos/packages/reflect/deus/src/cli/cli.test.ts]
13
+ ```
@@ -0,0 +1,9 @@
1
+ //
2
+ // Copyright 2026 DXOS.org
3
+ //
4
+
5
+ export default {
6
+ plugin: {
7
+ id: 'org.example.plugin.sample',
8
+ },
9
+ };
@@ -0,0 +1,9 @@
1
+ ---
2
+ id: org.example.plugin.sample
3
+ ---
4
+
5
+ ```mdl
6
+ plugin SamplePlugin: Sample.
7
+ id: org.example.plugin.sample
8
+ dependsOn: [org.example.plugin.a]
9
+ ```
@@ -0,0 +1,13 @@
1
+ ---
2
+ spec: github:dxos/dxos/packages/reflect/deus/src/cli/__fixtures__/review/plugin-deps-mismatch/PLUGIN.mdl
3
+ commit: 0000000000000000000000000000000000000000
4
+ date: 2026-10-27
5
+ by: agent:claude-code
6
+ ---
7
+
8
+ ```mdl
9
+ verdict SamplePlugin: Sample
10
+ status: done
11
+ evidence: [github:dxos/dxos/packages/reflect/deus/src/cli/review.ts#checkReview]
12
+ tests: [github:dxos/dxos/packages/reflect/deus/src/cli/cli.test.ts]
13
+ ```
@@ -0,0 +1,10 @@
1
+ //
2
+ // Copyright 2026 DXOS.org
3
+ //
4
+
5
+ export default {
6
+ plugin: {
7
+ id: 'org.example.plugin.sample',
8
+ dependsOn: ['org.example.plugin.a', 'org.example.plugin.b'],
9
+ },
10
+ };
@@ -0,0 +1,9 @@
1
+ ---
2
+ id: org.example.plugin.sample
3
+ ---
4
+
5
+ ```mdl
6
+ plugin SamplePlugin: Sample.
7
+ id: org.example.plugin.sample
8
+ dependsOn: [org.example.plugin.a]
9
+ ```
@@ -0,0 +1,13 @@
1
+ ---
2
+ spec: github:dxos/dxos/packages/reflect/deus/src/cli/__fixtures__/review/plugin-deps-noplugin/PLUGIN.mdl
3
+ commit: 0000000000000000000000000000000000000000
4
+ date: 2026-10-27
5
+ by: agent:claude-code
6
+ ---
7
+
8
+ ```mdl
9
+ verdict SamplePlugin: Sample
10
+ status: done
11
+ evidence: [github:dxos/dxos/packages/reflect/deus/src/cli/review.ts#checkReview]
12
+ tests: [github:dxos/dxos/packages/reflect/deus/src/cli/cli.test.ts]
13
+ ```
@@ -0,0 +1,7 @@
1
+ //
2
+ // Copyright 2026 DXOS.org
3
+ //
4
+
5
+ export default {
6
+ name: 'sample',
7
+ };
@@ -0,0 +1,122 @@
1
+ //
2
+ // Copyright 2026 DXOS.org
3
+ //
4
+
5
+ import * as Command from 'effect/cli/Command';
6
+ import * as Flag from 'effect/cli/Flag';
7
+ import * as Config from 'effect/Config';
8
+ import * as Console from 'effect/Console';
9
+ import * as Effect from 'effect/Effect';
10
+ import * as FileSystem from 'effect/FileSystem';
11
+ import * as Path from 'effect/Path';
12
+
13
+ import { MISSING_DECISION, checkChangelogChange, lintMdl } from '../extension/check.ts';
14
+ import { ChangelogCheckError } from './errors.ts';
15
+ import { git, lines } from './git.ts';
16
+
17
+ /** A commit trailer that waives the missing-decision rule for a bulk mechanical edit; append-only rules still apply. */
18
+ export const WAIVER = 'Spec-Changelog-Skip';
19
+
20
+ /** Language definitions, review rules, spec reviews and test fixtures are .mdl files but not specs. */
21
+ const EXEMPT = [/^packages\/reflect\/deus\/lang\//, /\/__fixtures__\//, /(^|\/)rules\//, /\.review\.mdl$/];
22
+
23
+ export const DEFAULT_BASE_REF = 'origin/main';
24
+
25
+ export type ChangelogCheckOptions = {
26
+ /** Ref whose merge base with HEAD the working tree is compared against. */
27
+ base: string;
28
+ /** Repository directory; any path inside the work tree. */
29
+ cwd: string;
30
+ /** `GITHUB_EVENT_NAME`; the check runs only for pull requests or outside CI. */
31
+ event: string;
32
+ };
33
+
34
+ /**
35
+ * Fails when a changed .mdl spec has no new `## Changelog` decision, or edits the log in place (lang/changelog.mdl).
36
+ * Whitespace and small typo fixes need no decision; a `Spec-Changelog-Skip: <reason>` commit trailer waives the rule.
37
+ * Compares the working tree with the merge base of `base`, so a local run also covers uncommitted edits.
38
+ */
39
+ export const checkChangelog = Effect.fnUntraced(function* ({ base: baseRef, cwd, event }: ChangelogCheckOptions) {
40
+ // The rule is diff-based: on `main` every spec's history is already merged, so only a branch run means anything.
41
+ if (event && event !== 'pull_request') {
42
+ yield* Console.log(`Skipping on \`${event}\` — the changelog check is diff-based.`);
43
+ return;
44
+ }
45
+
46
+ const fs = yield* FileSystem.FileSystem;
47
+ const path = yield* Path.Path;
48
+ const root = yield* git(cwd, 'rev-parse', '--show-toplevel');
49
+ const base = yield* git(root, 'merge-base', baseRef, 'HEAD').pipe(Effect.orElseSucceed(() => baseRef));
50
+
51
+ const waivers = lines(yield* git(root, 'log', `${base}..HEAD`, `--format=%(trailers:key=${WAIVER},valueonly)`));
52
+ if (waivers.length > 0) {
53
+ yield* Console.log(`Missing-decision rule waived by ${WAIVER}: ${waivers.join('; ')}`);
54
+ }
55
+
56
+ // Path in the working tree → path at the base (undefined for a new file).
57
+ const changed = new Map<string, string | undefined>();
58
+ // Unquoted paths, so a non-ASCII file name reads back as the file it names.
59
+ const quotePath = ['-c', 'core.quotePath=false'];
60
+ for (const line of lines(
61
+ yield* git(root, ...quotePath, 'diff', '--name-status', '-M', '--diff-filter=AMR', base, '--', '*.mdl'),
62
+ )) {
63
+ const [status, ...paths] = line.split('\t');
64
+ changed.set(paths[paths.length - 1], status === 'A' ? undefined : paths[0]);
65
+ }
66
+ for (const file of lines(
67
+ yield* git(root, ...quotePath, 'ls-files', '--others', '--exclude-standard', '--', '*.mdl'),
68
+ )) {
69
+ changed.set(file, undefined);
70
+ }
71
+
72
+ let failures = 0;
73
+ for (const [file, basePath] of [...changed].sort(([a], [b]) => a.localeCompare(b))) {
74
+ if (EXEMPT.some((pattern) => pattern.test(file))) {
75
+ continue;
76
+ }
77
+ const after = yield* fs.readFileString(path.join(root, file));
78
+ const before = basePath === undefined ? undefined : yield* git(root, 'show', `${base}:${basePath}`);
79
+ const errors = [
80
+ ...checkChangelogChange(before, after).filter((error) => waivers.length === 0 || error !== MISSING_DECISION),
81
+ ...lintMdl(after)
82
+ .filter(({ source }) => source === 'mdl/decision')
83
+ .map(({ message }) => message),
84
+ ];
85
+ for (const error of errors) {
86
+ yield* Console.log(`${file}: ${error}`);
87
+ }
88
+ failures += errors.length;
89
+ }
90
+
91
+ if (failures > 0) {
92
+ yield* Console.log(
93
+ `\n${failures} changelog error(s). Every spec change adds a decision — see .agents/skills/mdl/SKILL.md.`,
94
+ );
95
+ return yield* Effect.fail(new ChangelogCheckError({ context: { failures } }));
96
+ }
97
+ yield* Console.log(`OK: ${changed.size} changed .mdl file(s) checked against ${baseRef}.`);
98
+ });
99
+
100
+ const check = Command.make(
101
+ 'check',
102
+ {
103
+ base: Flag.String('base').pipe(
104
+ Flag.withDescription('Ref to diff against, via its merge base with HEAD (env MDL_BASE_REF).'),
105
+ Flag.withFallbackConfig(Config.String('MDL_BASE_REF')),
106
+ Flag.withDefault(DEFAULT_BASE_REF),
107
+ ),
108
+ },
109
+ Effect.fnUntraced(function* ({ base }) {
110
+ const event = yield* Config.String('GITHUB_EVENT_NAME').pipe(Config.withDefault(''));
111
+ yield* checkChangelog({ base, cwd: process.cwd(), event });
112
+ }),
113
+ ).pipe(
114
+ Command.withDescription(
115
+ 'Fail when a changed .mdl spec adds no `## Changelog` decision or edits an existing one (waive with a `Spec-Changelog-Skip:` trailer).',
116
+ ),
117
+ );
118
+
119
+ export const changelog = Command.make('changelog').pipe(
120
+ Command.withDescription('Spec changelog tools.'),
121
+ Command.withSubcommands([check]),
122
+ );