@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.
- package/LICENSE +105 -0
- package/README.md +24 -2
- package/bin/deus.ts +42 -0
- package/dist/lib/chunk-blocks.mjs +151 -0
- package/dist/lib/chunk-blocks.mjs.map +1 -0
- package/dist/lib/chunk-check.mjs +452 -0
- package/dist/lib/chunk-check.mjs.map +1 -0
- package/dist/lib/chunk-completion.mjs +112 -0
- package/dist/lib/chunk-completion.mjs.map +1 -0
- package/dist/lib/chunk-extension.mjs +396 -0
- package/dist/lib/chunk-extension.mjs.map +1 -0
- package/dist/lib/chunk-parse.mjs +21 -0
- package/dist/lib/chunk-parse.mjs.map +1 -0
- package/dist/lib/cli.mjs +946 -0
- package/dist/lib/cli.mjs.map +1 -0
- package/dist/lib/extension.mjs +4 -0
- package/dist/lib/index.mjs +6 -0
- package/dist/lib/parse.mjs +4 -0
- package/dist/lib/review.mjs +260 -0
- package/dist/lib/review.mjs.map +1 -0
- package/dist/lib/spec-index.mjs +28 -0
- package/dist/lib/spec-index.mjs.map +1 -0
- package/dist/types/bin/deus.d.ts +3 -0
- package/dist/types/bin/deus.d.ts.map +1 -0
- package/dist/types/src/cli/__fixtures__/review/plugin-deps/dx.config.d.ts +8 -0
- package/dist/types/src/cli/__fixtures__/review/plugin-deps/dx.config.d.ts.map +1 -0
- package/dist/types/src/cli/__fixtures__/review/plugin-deps-diverged/dx.config.d.ts +8 -0
- package/dist/types/src/cli/__fixtures__/review/plugin-deps-diverged/dx.config.d.ts.map +1 -0
- package/dist/types/src/cli/__fixtures__/review/plugin-deps-empty/dx.config.d.ts +7 -0
- package/dist/types/src/cli/__fixtures__/review/plugin-deps-empty/dx.config.d.ts.map +1 -0
- package/dist/types/src/cli/__fixtures__/review/plugin-deps-mismatch/dx.config.d.ts +8 -0
- package/dist/types/src/cli/__fixtures__/review/plugin-deps-mismatch/dx.config.d.ts.map +1 -0
- package/dist/types/src/cli/__fixtures__/review/plugin-deps-noplugin/dx.config.d.ts +5 -0
- package/dist/types/src/cli/__fixtures__/review/plugin-deps-noplugin/dx.config.d.ts.map +1 -0
- package/dist/types/src/cli/changelog.d.ts +25 -0
- package/dist/types/src/cli/changelog.d.ts.map +1 -0
- package/dist/types/src/cli/cli.test.d.ts +2 -0
- package/dist/types/src/cli/cli.test.d.ts.map +1 -0
- package/dist/types/src/cli/errors.d.ts +183 -0
- package/dist/types/src/cli/errors.d.ts.map +1 -0
- package/dist/types/src/cli/features.d.ts +58 -0
- package/dist/types/src/cli/features.d.ts.map +1 -0
- package/dist/types/src/cli/git.d.ts +8 -0
- package/dist/types/src/cli/git.d.ts.map +1 -0
- package/dist/types/src/cli/index.d.ts +12 -0
- package/dist/types/src/cli/index.d.ts.map +1 -0
- package/dist/types/src/cli/lint.d.ts +17 -0
- package/dist/types/src/cli/lint.d.ts.map +1 -0
- package/dist/types/src/cli/qa-lint.d.ts +40 -0
- package/dist/types/src/cli/qa-lint.d.ts.map +1 -0
- package/dist/types/src/cli/qa.d.ts +86 -0
- package/dist/types/src/cli/qa.d.ts.map +1 -0
- package/dist/types/src/cli/review.d.ts +38 -0
- package/dist/types/src/cli/review.d.ts.map +1 -0
- package/dist/types/src/cli/spec-index.d.ts +17 -0
- package/dist/types/src/cli/spec-index.d.ts.map +1 -0
- package/dist/types/src/extension/blocks.d.ts +65 -0
- package/dist/types/src/extension/blocks.d.ts.map +1 -0
- package/dist/types/src/extension/check.d.ts +99 -0
- package/dist/types/src/extension/check.d.ts.map +1 -0
- package/dist/types/src/extension/check.test.d.ts +2 -0
- package/dist/types/src/extension/check.test.d.ts.map +1 -0
- package/dist/types/src/extension/code.d.ts +7 -0
- package/dist/types/src/extension/code.d.ts.map +1 -0
- package/dist/types/src/extension/complete.d.ts +6 -0
- package/dist/types/src/extension/complete.d.ts.map +1 -0
- package/dist/types/src/extension/completion.d.ts +10 -0
- package/dist/types/src/extension/completion.d.ts.map +1 -0
- package/dist/types/src/extension/constants.d.ts +6 -0
- package/dist/types/src/extension/constants.d.ts.map +1 -0
- package/dist/types/src/extension/fences.d.ts +10 -0
- package/dist/types/src/extension/fences.d.ts.map +1 -0
- package/dist/types/src/extension/gen/mdl.d.ts +3 -0
- package/dist/types/src/extension/gen/mdl.d.ts.map +1 -0
- package/dist/types/src/extension/gen/mdl.terms.d.ts +2 -0
- package/dist/types/src/extension/gen/mdl.terms.d.ts.map +1 -0
- package/dist/types/src/extension/index.d.ts +8 -0
- package/dist/types/src/extension/index.d.ts.map +1 -0
- package/dist/types/src/extension/language.d.ts +20 -0
- package/dist/types/src/extension/language.d.ts.map +1 -0
- package/dist/types/src/extension/lint.d.ts +8 -0
- package/dist/types/src/extension/lint.d.ts.map +1 -0
- package/dist/types/src/extension/parse.d.ts +6 -0
- package/dist/types/src/extension/parse.d.ts.map +1 -0
- package/dist/types/src/extension/parser.test.d.ts +2 -0
- package/dist/types/src/extension/parser.test.d.ts.map +1 -0
- package/dist/types/src/extension/refs.d.ts +32 -0
- package/dist/types/src/extension/refs.d.ts.map +1 -0
- package/dist/types/src/extension/refs.test.d.ts +2 -0
- package/dist/types/src/extension/refs.test.d.ts.map +1 -0
- package/dist/types/src/extension/syntax.d.ts +12 -0
- package/dist/types/src/extension/syntax.d.ts.map +1 -0
- package/dist/types/src/index.d.ts +3 -0
- package/dist/types/src/index.d.ts.map +1 -0
- package/dist/types/src/review/fields.d.ts +9 -0
- package/dist/types/src/review/fields.d.ts.map +1 -0
- package/dist/types/src/review/index.d.ts +5 -0
- package/dist/types/src/review/index.d.ts.map +1 -0
- package/dist/types/src/review/review.d.ts +70 -0
- package/dist/types/src/review/review.d.ts.map +1 -0
- package/dist/types/src/review/review.test.d.ts +2 -0
- package/dist/types/src/review/review.test.d.ts.map +1 -0
- package/dist/types/src/review/source-key.d.ts +35 -0
- package/dist/types/src/review/source-key.d.ts.map +1 -0
- package/dist/types/src/review/symbol.d.ts +17 -0
- package/dist/types/src/review/symbol.d.ts.map +1 -0
- package/dist/types/src/review/symbol.test.d.ts +2 -0
- package/dist/types/src/review/symbol.test.d.ts.map +1 -0
- package/dist/types/src/spec-index/index.d.ts +3 -0
- package/dist/types/src/spec-index/index.d.ts.map +1 -0
- package/dist/types/src/spec-index/parse.d.ts +11 -0
- package/dist/types/src/spec-index/parse.d.ts.map +1 -0
- package/dist/types/src/spec-index/spec-index.d.ts +21 -0
- package/dist/types/src/spec-index/spec-index.d.ts.map +1 -0
- package/dist/types/src/spec-index/spec-index.test.d.ts +2 -0
- package/dist/types/src/spec-index/spec-index.test.d.ts.map +1 -0
- package/dist/types/tsconfig.tsbuildinfo +1 -0
- package/docs/DESIGN.md +561 -0
- package/docs/IDIOMS.md +265 -0
- package/lang/PLUGIN-.template.mdl +115 -0
- package/lang/app.mdl +200 -0
- package/lang/changelog.mdl +184 -0
- package/lang/core.mdl +203 -0
- package/lang/examples/chess-1.mdl +149 -0
- package/lang/examples/chess-2.mdl +203 -0
- package/lang/examples/chess-3.mdl +231 -0
- package/lang/features.mdl +92 -0
- package/lang/plugin.mdl +59 -0
- package/lang/qa.mdl +383 -0
- package/lang/review.mdl +103 -0
- package/lang/sql.mdl +72 -0
- package/package.json +74 -3
- package/src/cli/__fixtures__/bad-decision.mdl +13 -0
- package/src/cli/__fixtures__/features/CYCLE.mdl +25 -0
- package/src/cli/__fixtures__/features/FEATURES.mdl +47 -0
- package/src/cli/__fixtures__/features/SPEC.mdl +22 -0
- package/src/cli/__fixtures__/features/SPEC.review.mdl +32 -0
- package/src/cli/__fixtures__/features/TASKS.md +5 -0
- package/src/cli/__fixtures__/lint-refs/SPEC.mdl +7 -0
- package/src/cli/__fixtures__/lint-refs/SPEC.review.mdl +7 -0
- package/src/cli/__fixtures__/qa-lint/packages/plugins/plugin-risky/PLUGIN.mdl +29 -0
- package/src/cli/__fixtures__/qa-list/plugin-sample/spec/PLUGIN.mdl +51 -0
- package/src/cli/__fixtures__/review/SPEC.mdl +23 -0
- package/src/cli/__fixtures__/review/SPEC.review.mdl +26 -0
- package/src/cli/__fixtures__/review/plugin-deps/PLUGIN.mdl +9 -0
- package/src/cli/__fixtures__/review/plugin-deps/PLUGIN.review.mdl +13 -0
- package/src/cli/__fixtures__/review/plugin-deps/dx.config.ts +10 -0
- package/src/cli/__fixtures__/review/plugin-deps-diverged/PLUGIN.mdl +9 -0
- package/src/cli/__fixtures__/review/plugin-deps-diverged/PLUGIN.review.mdl +14 -0
- package/src/cli/__fixtures__/review/plugin-deps-diverged/dx.config.ts +10 -0
- package/src/cli/__fixtures__/review/plugin-deps-empty/PLUGIN.mdl +9 -0
- package/src/cli/__fixtures__/review/plugin-deps-empty/PLUGIN.review.mdl +13 -0
- package/src/cli/__fixtures__/review/plugin-deps-empty/dx.config.ts +9 -0
- package/src/cli/__fixtures__/review/plugin-deps-mismatch/PLUGIN.mdl +9 -0
- package/src/cli/__fixtures__/review/plugin-deps-mismatch/PLUGIN.review.mdl +13 -0
- package/src/cli/__fixtures__/review/plugin-deps-mismatch/dx.config.ts +10 -0
- package/src/cli/__fixtures__/review/plugin-deps-noplugin/PLUGIN.mdl +9 -0
- package/src/cli/__fixtures__/review/plugin-deps-noplugin/PLUGIN.review.mdl +13 -0
- package/src/cli/__fixtures__/review/plugin-deps-noplugin/dx.config.ts +7 -0
- package/src/cli/changelog.ts +122 -0
- package/src/cli/cli.test.ts +359 -0
- package/src/cli/errors.ts +23 -0
- package/src/cli/features.ts +320 -0
- package/src/cli/git.ts +35 -0
- package/src/cli/index.ts +27 -0
- package/src/cli/lint.ts +75 -0
- package/src/cli/qa-lint.ts +206 -0
- package/src/cli/qa.ts +300 -0
- package/src/cli/review.ts +359 -0
- package/src/cli/spec-index.ts +54 -0
- package/src/extension/blocks.ts +169 -0
- package/src/extension/check.test.ts +629 -0
- package/src/extension/check.ts +552 -0
- package/src/extension/code.ts +99 -0
- package/src/extension/complete.ts +34 -0
- package/src/extension/completion.ts +64 -0
- package/src/extension/constants.ts +28 -0
- package/src/extension/fences.ts +270 -0
- package/src/extension/gen/mdl.terms.ts +16 -0
- package/src/extension/gen/mdl.ts +16 -0
- package/src/extension/index.ts +25 -0
- package/src/extension/language.ts +33 -0
- package/src/extension/lint.ts +19 -0
- package/src/extension/mdl.grammar +60 -0
- package/src/extension/parse.ts +31 -0
- package/src/extension/parser.test.ts +248 -0
- package/src/extension/refs.test.ts +95 -0
- package/src/extension/refs.ts +94 -0
- package/src/extension/syntax.ts +25 -0
- package/src/index.ts +6 -0
- package/src/review/fields.ts +31 -0
- package/src/review/index.ts +8 -0
- package/src/review/review.test.ts +111 -0
- package/src/review/review.ts +184 -0
- package/src/review/source-key.ts +63 -0
- package/src/review/symbol.test.ts +47 -0
- package/src/review/symbol.ts +96 -0
- package/src/spec-index/index.ts +6 -0
- package/src/spec-index/parse.ts +22 -0
- package/src/spec-index/spec-index.test.ts +56 -0
- 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,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,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,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,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,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,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,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
|
+
);
|