mdkg 0.0.9 → 0.1.1
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/CHANGELOG.md +29 -0
- package/README.md +20 -2
- package/dist/cli.js +35 -0
- package/dist/commands/doctor.js +10 -2
- package/dist/commands/init.js +4 -0
- package/dist/commands/init_manifest.js +131 -0
- package/dist/commands/new.js +3 -0
- package/dist/commands/upgrade.js +401 -0
- package/dist/commands/validate.js +5 -1
- package/dist/core/version.js +31 -0
- package/dist/graph/template_schema.js +33 -5
- package/dist/init/AGENT_START.md +1 -0
- package/dist/init/CLI_COMMAND_MATRIX.md +8 -0
- package/dist/init/README.md +7 -0
- package/dist/init/core/rule-6-templates-and-schemas.md +3 -1
- package/dist/init/init-manifest.json +197 -0
- package/dist/init/legacy/v0.0.9-init-manifest.json +197 -0
- package/dist/init/skills/default/verify-close-and-checkpoint/SKILL.md +11 -10
- package/dist/templates/builtin.js +38 -0
- package/dist/templates/loader.js +9 -16
- package/dist/util/argparse.js +1 -0
- package/package.json +3 -2
|
@@ -0,0 +1,197 @@
|
|
|
1
|
+
{
|
|
2
|
+
"schema_version": 1,
|
|
3
|
+
"tool": "mdkg",
|
|
4
|
+
"mdkg_version": "0.1.1",
|
|
5
|
+
"files": [
|
|
6
|
+
{
|
|
7
|
+
"path": ".mdkg/config.json",
|
|
8
|
+
"category": "config",
|
|
9
|
+
"sha256": "eb76bf22ae9d04601c2fedac5fd22838797dd2cc829324638a6b69222d40aaa9"
|
|
10
|
+
},
|
|
11
|
+
{
|
|
12
|
+
"path": ".mdkg/core/core.md",
|
|
13
|
+
"category": "core",
|
|
14
|
+
"sha256": "d87beecf4229535c0d0feea7deae28b97d0681105a1c282d9961e97918f0bbe8"
|
|
15
|
+
},
|
|
16
|
+
{
|
|
17
|
+
"path": ".mdkg/core/guide.md",
|
|
18
|
+
"category": "core",
|
|
19
|
+
"sha256": "0b0ba51fbc393b3d5e0a0df4dece6aa822b77ab0f4ee3814b2cdba77ef8b65d9"
|
|
20
|
+
},
|
|
21
|
+
{
|
|
22
|
+
"path": ".mdkg/core/HUMAN.md",
|
|
23
|
+
"category": "core",
|
|
24
|
+
"sha256": "75d2e015cd5ba61062cb84246017ee4f4221610d4a56e4a0b332271b90694965"
|
|
25
|
+
},
|
|
26
|
+
{
|
|
27
|
+
"path": ".mdkg/core/rule-1-mdkg-conventions.md",
|
|
28
|
+
"category": "core",
|
|
29
|
+
"sha256": "20073cd21c148f1b93a382550f835ccb2e896cc676903328557004319235c112"
|
|
30
|
+
},
|
|
31
|
+
{
|
|
32
|
+
"path": ".mdkg/core/rule-2-context-pack-rules.md",
|
|
33
|
+
"category": "core",
|
|
34
|
+
"sha256": "9dfd46b5ae791220c68304abc0784399509cf606821c937671cf63d6e9a8ce8f"
|
|
35
|
+
},
|
|
36
|
+
{
|
|
37
|
+
"path": ".mdkg/core/rule-3-cli-contract.md",
|
|
38
|
+
"category": "core",
|
|
39
|
+
"sha256": "b547a6edc20112013c607a033af4ac0c6bb3f9d66d445b0c545b2890a721b671"
|
|
40
|
+
},
|
|
41
|
+
{
|
|
42
|
+
"path": ".mdkg/core/rule-4-repo-safety-and-ignores.md",
|
|
43
|
+
"category": "core",
|
|
44
|
+
"sha256": "d7fc4bfa3727ed7d5353eeb0089ad818b96a755578e217251106422559750291"
|
|
45
|
+
},
|
|
46
|
+
{
|
|
47
|
+
"path": ".mdkg/core/rule-5-release-and-versioning.md",
|
|
48
|
+
"category": "core",
|
|
49
|
+
"sha256": "4fc6648052f80b90b2efc173e3bcab16cb0bc6680bb8b04f76c66fff06ad19cd"
|
|
50
|
+
},
|
|
51
|
+
{
|
|
52
|
+
"path": ".mdkg/core/rule-6-templates-and-schemas.md",
|
|
53
|
+
"category": "core",
|
|
54
|
+
"sha256": "7f0a92ccd35f378b487969f06820a61790b02a59aeb14755fe506278f056fd59"
|
|
55
|
+
},
|
|
56
|
+
{
|
|
57
|
+
"path": ".mdkg/core/SOUL.md",
|
|
58
|
+
"category": "core",
|
|
59
|
+
"sha256": "2bfdd4d1a65dd18c14d3e8469d0d5c74c6cc7c067f0b56d227532b7ab620795a"
|
|
60
|
+
},
|
|
61
|
+
{
|
|
62
|
+
"path": ".mdkg/README.md",
|
|
63
|
+
"category": "mdkg_doc",
|
|
64
|
+
"sha256": "f4078fef50e6866d6f7e3a40351e72fc15d3e1abd334e7119d89c696bc4a9100"
|
|
65
|
+
},
|
|
66
|
+
{
|
|
67
|
+
"path": ".mdkg/skills/build-pack-and-execute-task/SKILL.md",
|
|
68
|
+
"category": "default_skill",
|
|
69
|
+
"sha256": "7f6104980e6b2ec0749881c6be2bd3d7982702259c4979763266d1c800aeb410"
|
|
70
|
+
},
|
|
71
|
+
{
|
|
72
|
+
"path": ".mdkg/skills/select-work-and-ground-context/SKILL.md",
|
|
73
|
+
"category": "default_skill",
|
|
74
|
+
"sha256": "c8c04134532deda079f9ee290a66b2423892f9789fa946e44db4c89c05b8e1bf"
|
|
75
|
+
},
|
|
76
|
+
{
|
|
77
|
+
"path": ".mdkg/skills/verify-close-and-checkpoint/SKILL.md",
|
|
78
|
+
"category": "default_skill",
|
|
79
|
+
"sha256": "98a1b02927854201eeea73e3d7c9f5a104fab7a5c72e033ea261995341a8a7ce"
|
|
80
|
+
},
|
|
81
|
+
{
|
|
82
|
+
"path": ".mdkg/templates/default/bug.md",
|
|
83
|
+
"category": "template",
|
|
84
|
+
"sha256": "88e3f8d67aa3b2156be2006bd1c8139b7b16b46f2c05a4f4d840b3746a40f9c5"
|
|
85
|
+
},
|
|
86
|
+
{
|
|
87
|
+
"path": ".mdkg/templates/default/chk.md",
|
|
88
|
+
"category": "template",
|
|
89
|
+
"sha256": "15f793e422009c76f8bda72c3609157acd7f03762d9c9bdb096c4aa2e2c3fb89"
|
|
90
|
+
},
|
|
91
|
+
{
|
|
92
|
+
"path": ".mdkg/templates/default/dec.md",
|
|
93
|
+
"category": "template",
|
|
94
|
+
"sha256": "a2f7098fea538c153ac290f2e2edb2e755ca9dd07d17c2a127fb23959517ece9"
|
|
95
|
+
},
|
|
96
|
+
{
|
|
97
|
+
"path": ".mdkg/templates/default/dispute.md",
|
|
98
|
+
"category": "template",
|
|
99
|
+
"sha256": "b1c5330fd4a1e3f03dbb4ac8907bd728e55537e053dcf43ebcbdc835ff1d0579"
|
|
100
|
+
},
|
|
101
|
+
{
|
|
102
|
+
"path": ".mdkg/templates/default/edd.md",
|
|
103
|
+
"category": "template",
|
|
104
|
+
"sha256": "44828719927cfd31389b9d55b57fc4fa9bc640f3e2475baefe585e4043740f5e"
|
|
105
|
+
},
|
|
106
|
+
{
|
|
107
|
+
"path": ".mdkg/templates/default/epic.md",
|
|
108
|
+
"category": "template",
|
|
109
|
+
"sha256": "56697b69af027fe08c00866c0c0670f7d7e2a0857803bd4aabb99f4761311879"
|
|
110
|
+
},
|
|
111
|
+
{
|
|
112
|
+
"path": ".mdkg/templates/default/feat.md",
|
|
113
|
+
"category": "template",
|
|
114
|
+
"sha256": "99cfdd97b40b119cf899fd766d816c07b7daaafd8ec8e70e6c6de5c0d37f581c"
|
|
115
|
+
},
|
|
116
|
+
{
|
|
117
|
+
"path": ".mdkg/templates/default/feedback.md",
|
|
118
|
+
"category": "template",
|
|
119
|
+
"sha256": "61ad7b8b717d17736ba505f814fa6e4f9ec61f7fe4ae6622359304620a99d649"
|
|
120
|
+
},
|
|
121
|
+
{
|
|
122
|
+
"path": ".mdkg/templates/default/prd.md",
|
|
123
|
+
"category": "template",
|
|
124
|
+
"sha256": "afee167576a4f881ab191867e118864b7b5629e14b9c4a61359c8fbd7ececeee"
|
|
125
|
+
},
|
|
126
|
+
{
|
|
127
|
+
"path": ".mdkg/templates/default/prop.md",
|
|
128
|
+
"category": "template",
|
|
129
|
+
"sha256": "839b976a8ddc0d6abddfbe6114dfb87f64471958ae807c011538777b758aa1f0"
|
|
130
|
+
},
|
|
131
|
+
{
|
|
132
|
+
"path": ".mdkg/templates/default/proposal.md",
|
|
133
|
+
"category": "template",
|
|
134
|
+
"sha256": "16bfa81b6e665064e93e0d1b625dccc518b9885f87a32a15e5ba5441c2c27ea8"
|
|
135
|
+
},
|
|
136
|
+
{
|
|
137
|
+
"path": ".mdkg/templates/default/receipt.md",
|
|
138
|
+
"category": "template",
|
|
139
|
+
"sha256": "aac6e6e27153a1ca85a515b03f0ac55db3eb0df3f9243c42f0b936f5e5a750b2"
|
|
140
|
+
},
|
|
141
|
+
{
|
|
142
|
+
"path": ".mdkg/templates/default/rule.md",
|
|
143
|
+
"category": "template",
|
|
144
|
+
"sha256": "6321abf72af61a6513d7bfaa2d3122b2aa3bd2b95b662a52d569fb2bf819fda1"
|
|
145
|
+
},
|
|
146
|
+
{
|
|
147
|
+
"path": ".mdkg/templates/default/spec.md",
|
|
148
|
+
"category": "template",
|
|
149
|
+
"sha256": "e3e05d8d627c478d2757451f61b5a8fda8a75da9885a9261b2f8f5cb8a3a36dc"
|
|
150
|
+
},
|
|
151
|
+
{
|
|
152
|
+
"path": ".mdkg/templates/default/task.md",
|
|
153
|
+
"category": "template",
|
|
154
|
+
"sha256": "f6385dd4f56f1c8df164ac3e79d82c5a3fde3f952dc9cdc78c0b8077caa62277"
|
|
155
|
+
},
|
|
156
|
+
{
|
|
157
|
+
"path": ".mdkg/templates/default/test.md",
|
|
158
|
+
"category": "template",
|
|
159
|
+
"sha256": "bdae53e5cb4bd77712da155bbcfc24409ced8162c977e6bc478a9d1e695ddef7"
|
|
160
|
+
},
|
|
161
|
+
{
|
|
162
|
+
"path": ".mdkg/templates/default/work_order.md",
|
|
163
|
+
"category": "template",
|
|
164
|
+
"sha256": "bdbdf6e34d59976a675dd1d25002dfc0ef49e725647c97a9e0b3552c93fb8600"
|
|
165
|
+
},
|
|
166
|
+
{
|
|
167
|
+
"path": ".mdkg/templates/default/work.md",
|
|
168
|
+
"category": "template",
|
|
169
|
+
"sha256": "651b7339f6e23c8745264f3f6641a0c82fcd765247f0a70a9f407a118a49ec00"
|
|
170
|
+
},
|
|
171
|
+
{
|
|
172
|
+
"path": "AGENT_START.md",
|
|
173
|
+
"category": "startup_doc",
|
|
174
|
+
"sha256": "be0990bb81e194a2a396f9520cda66c34d0bbbd36daa5b48773246549aacab2e"
|
|
175
|
+
},
|
|
176
|
+
{
|
|
177
|
+
"path": "AGENTS.md",
|
|
178
|
+
"category": "agent_doc",
|
|
179
|
+
"sha256": "9e33a1c20320e317e1e37dbb09fd0303e355b9e7d49cf2128fe791aaa2ce2fb1"
|
|
180
|
+
},
|
|
181
|
+
{
|
|
182
|
+
"path": "CLAUDE.md",
|
|
183
|
+
"category": "agent_doc",
|
|
184
|
+
"sha256": "3ff3ec5560968f7f1bf6f7d34a3c4b6e636edc9f0d45f717cdebc4df3b76403a"
|
|
185
|
+
},
|
|
186
|
+
{
|
|
187
|
+
"path": "CLI_COMMAND_MATRIX.md",
|
|
188
|
+
"category": "startup_doc",
|
|
189
|
+
"sha256": "5ac721d2569c4da2a3b7f18e62c816eb3898e8deb06429f17f0615f4a8da2183"
|
|
190
|
+
},
|
|
191
|
+
{
|
|
192
|
+
"path": "llms.txt",
|
|
193
|
+
"category": "startup_doc",
|
|
194
|
+
"sha256": "8316bb8f634c6fb290ef1591e9c5b9786a2ddc06d25ab7d448fce8f4aebf65b8"
|
|
195
|
+
}
|
|
196
|
+
]
|
|
197
|
+
}
|
|
@@ -0,0 +1,197 @@
|
|
|
1
|
+
{
|
|
2
|
+
"schema_version": 1,
|
|
3
|
+
"tool": "mdkg",
|
|
4
|
+
"mdkg_version": "0.0.9",
|
|
5
|
+
"files": [
|
|
6
|
+
{
|
|
7
|
+
"path": ".mdkg/config.json",
|
|
8
|
+
"category": "config",
|
|
9
|
+
"sha256": "eb76bf22ae9d04601c2fedac5fd22838797dd2cc829324638a6b69222d40aaa9"
|
|
10
|
+
},
|
|
11
|
+
{
|
|
12
|
+
"path": ".mdkg/core/HUMAN.md",
|
|
13
|
+
"category": "core",
|
|
14
|
+
"sha256": "75d2e015cd5ba61062cb84246017ee4f4221610d4a56e4a0b332271b90694965"
|
|
15
|
+
},
|
|
16
|
+
{
|
|
17
|
+
"path": ".mdkg/core/SOUL.md",
|
|
18
|
+
"category": "core",
|
|
19
|
+
"sha256": "2bfdd4d1a65dd18c14d3e8469d0d5c74c6cc7c067f0b56d227532b7ab620795a"
|
|
20
|
+
},
|
|
21
|
+
{
|
|
22
|
+
"path": ".mdkg/core/core.md",
|
|
23
|
+
"category": "core",
|
|
24
|
+
"sha256": "d87beecf4229535c0d0feea7deae28b97d0681105a1c282d9961e97918f0bbe8"
|
|
25
|
+
},
|
|
26
|
+
{
|
|
27
|
+
"path": ".mdkg/core/guide.md",
|
|
28
|
+
"category": "core",
|
|
29
|
+
"sha256": "0b0ba51fbc393b3d5e0a0df4dece6aa822b77ab0f4ee3814b2cdba77ef8b65d9"
|
|
30
|
+
},
|
|
31
|
+
{
|
|
32
|
+
"path": ".mdkg/core/rule-1-mdkg-conventions.md",
|
|
33
|
+
"category": "core",
|
|
34
|
+
"sha256": "20073cd21c148f1b93a382550f835ccb2e896cc676903328557004319235c112"
|
|
35
|
+
},
|
|
36
|
+
{
|
|
37
|
+
"path": ".mdkg/core/rule-2-context-pack-rules.md",
|
|
38
|
+
"category": "core",
|
|
39
|
+
"sha256": "9dfd46b5ae791220c68304abc0784399509cf63d6e9a8ce8f"
|
|
40
|
+
},
|
|
41
|
+
{
|
|
42
|
+
"path": ".mdkg/core/rule-3-cli-contract.md",
|
|
43
|
+
"category": "core",
|
|
44
|
+
"sha256": "b547a6edc20112013c607a033af4ac0c6bb3f9d66d445b0c545b2890a721b671"
|
|
45
|
+
},
|
|
46
|
+
{
|
|
47
|
+
"path": ".mdkg/core/rule-4-repo-safety-and-ignores.md",
|
|
48
|
+
"category": "core",
|
|
49
|
+
"sha256": "d7fc4bfa3727ed7d5353eeb0089ad818b96a755578e217251106422559750291"
|
|
50
|
+
},
|
|
51
|
+
{
|
|
52
|
+
"path": ".mdkg/core/rule-5-release-and-versioning.md",
|
|
53
|
+
"category": "core",
|
|
54
|
+
"sha256": "4fc6648052f80b90b2efc173e3bcab16cb0bc6680bb8b04f76c66fff06ad19cd"
|
|
55
|
+
},
|
|
56
|
+
{
|
|
57
|
+
"path": ".mdkg/core/rule-6-templates-and-schemas.md",
|
|
58
|
+
"category": "core",
|
|
59
|
+
"sha256": "0d6da477c12e3492f43c571a6e4daa373bf05005ef703ad5166b7c8786e553b0"
|
|
60
|
+
},
|
|
61
|
+
{
|
|
62
|
+
"path": ".mdkg/README.md",
|
|
63
|
+
"category": "mdkg_doc",
|
|
64
|
+
"sha256": "580ed58d4406783f79dd839902de3238647c99605e0849a87ca19a6bd9c738a2"
|
|
65
|
+
},
|
|
66
|
+
{
|
|
67
|
+
"path": ".mdkg/skills/build-pack-and-execute-task/SKILL.md",
|
|
68
|
+
"category": "default_skill",
|
|
69
|
+
"sha256": "7f6104980e6b2ec0749881c6be2bd3d7982702259c4979763266d1c800aeb410"
|
|
70
|
+
},
|
|
71
|
+
{
|
|
72
|
+
"path": ".mdkg/skills/select-work-and-ground-context/SKILL.md",
|
|
73
|
+
"category": "default_skill",
|
|
74
|
+
"sha256": "c8c04134532deda079f9ee290a66b2423892f9789fa946e44db4c89c05b8e1bf"
|
|
75
|
+
},
|
|
76
|
+
{
|
|
77
|
+
"path": ".mdkg/skills/verify-close-and-checkpoint/SKILL.md",
|
|
78
|
+
"category": "default_skill",
|
|
79
|
+
"sha256": "1d1bbb2cb09d13bc469706e60c38f883457d507144a33fd2675a7c1c48118132"
|
|
80
|
+
},
|
|
81
|
+
{
|
|
82
|
+
"path": ".mdkg/templates/default/bug.md",
|
|
83
|
+
"category": "template",
|
|
84
|
+
"sha256": "88e3f8d67aa3b2156be2006bd1c8139b7b16b46f2c05a4f4d840b3746a40f9c5"
|
|
85
|
+
},
|
|
86
|
+
{
|
|
87
|
+
"path": ".mdkg/templates/default/chk.md",
|
|
88
|
+
"category": "template",
|
|
89
|
+
"sha256": "15f793e422009c76f8bda72c3609157acd7f03762d9c9bdb096c4aa2e2c3fb89"
|
|
90
|
+
},
|
|
91
|
+
{
|
|
92
|
+
"path": ".mdkg/templates/default/dec.md",
|
|
93
|
+
"category": "template",
|
|
94
|
+
"sha256": "a2f7098fea538c153ac290f2e2edb2e755ca9dd07d17c2a127fb23959517ece9"
|
|
95
|
+
},
|
|
96
|
+
{
|
|
97
|
+
"path": ".mdkg/templates/default/dispute.md",
|
|
98
|
+
"category": "template",
|
|
99
|
+
"sha256": "b1c5330fd4a1e3f03dbb4ac8907bd728e55537e053dcf43ebcbdc835ff1d0579"
|
|
100
|
+
},
|
|
101
|
+
{
|
|
102
|
+
"path": ".mdkg/templates/default/edd.md",
|
|
103
|
+
"category": "template",
|
|
104
|
+
"sha256": "44828719927cfd31389b9d55b57fc4fa9bc640f3e2475baefe585e4043740f5e"
|
|
105
|
+
},
|
|
106
|
+
{
|
|
107
|
+
"path": ".mdkg/templates/default/epic.md",
|
|
108
|
+
"category": "template",
|
|
109
|
+
"sha256": "56697b69af027fe08c00866c0c0670f7d7e2a0857803bd4aabb99f4761311879"
|
|
110
|
+
},
|
|
111
|
+
{
|
|
112
|
+
"path": ".mdkg/templates/default/feat.md",
|
|
113
|
+
"category": "template",
|
|
114
|
+
"sha256": "99cfdd97b40b119cf899fd766d816c07b7daaafd8ec8e70e6c6de5c0d37f581c"
|
|
115
|
+
},
|
|
116
|
+
{
|
|
117
|
+
"path": ".mdkg/templates/default/feedback.md",
|
|
118
|
+
"category": "template",
|
|
119
|
+
"sha256": "61ad7b8b717d17736ba505f814fa6e4f9ec61f7fe4ae6622359304620a99d649"
|
|
120
|
+
},
|
|
121
|
+
{
|
|
122
|
+
"path": ".mdkg/templates/default/prd.md",
|
|
123
|
+
"category": "template",
|
|
124
|
+
"sha256": "afee167576a4f881ab191867e118864b7b5629e14b9c4a61359c8fbd7ececeee"
|
|
125
|
+
},
|
|
126
|
+
{
|
|
127
|
+
"path": ".mdkg/templates/default/prop.md",
|
|
128
|
+
"category": "template",
|
|
129
|
+
"sha256": "839b976a8ddc0d6abddfbe6114dfb87f64471958ae807c011538777b758aa1f0"
|
|
130
|
+
},
|
|
131
|
+
{
|
|
132
|
+
"path": ".mdkg/templates/default/proposal.md",
|
|
133
|
+
"category": "template",
|
|
134
|
+
"sha256": "16bfa81b6e665064e93e0d1b625dccc518b9885f87a32a15e5ba5441c2c27ea8"
|
|
135
|
+
},
|
|
136
|
+
{
|
|
137
|
+
"path": ".mdkg/templates/default/receipt.md",
|
|
138
|
+
"category": "template",
|
|
139
|
+
"sha256": "aac6e6e27153a1ca85a515b03f0ac55db3eb0df3f9243c42f0b936f5e5a750b2"
|
|
140
|
+
},
|
|
141
|
+
{
|
|
142
|
+
"path": ".mdkg/templates/default/rule.md",
|
|
143
|
+
"category": "template",
|
|
144
|
+
"sha256": "6321abf72af61a6513d7bfaa2d3122b2aa3bd2b95b662a52d569fb2bf819fda1"
|
|
145
|
+
},
|
|
146
|
+
{
|
|
147
|
+
"path": ".mdkg/templates/default/spec.md",
|
|
148
|
+
"category": "template",
|
|
149
|
+
"sha256": "e3e05d8d627c478d2757451f61b5a8fda8a75da9885a9261b2f8f5cb8a3a36dc"
|
|
150
|
+
},
|
|
151
|
+
{
|
|
152
|
+
"path": ".mdkg/templates/default/task.md",
|
|
153
|
+
"category": "template",
|
|
154
|
+
"sha256": "f6385dd4f56f1c8df164ac3e79d82c5a3fde3f952dc9cdc78c0b8077caa62277"
|
|
155
|
+
},
|
|
156
|
+
{
|
|
157
|
+
"path": ".mdkg/templates/default/test.md",
|
|
158
|
+
"category": "template",
|
|
159
|
+
"sha256": "bdae53e5cb4bd77712da155bbcfc24409ced8162c977e6bc478a9d1e695ddef7"
|
|
160
|
+
},
|
|
161
|
+
{
|
|
162
|
+
"path": ".mdkg/templates/default/work.md",
|
|
163
|
+
"category": "template",
|
|
164
|
+
"sha256": "651b7339f6e23c8745264f3f6641a0c82fcd765247f0a70a9f407a118a49ec00"
|
|
165
|
+
},
|
|
166
|
+
{
|
|
167
|
+
"path": ".mdkg/templates/default/work_order.md",
|
|
168
|
+
"category": "template",
|
|
169
|
+
"sha256": "bdbdf6e34d59976a675dd1d25002dfc0ef49e725647c97a9e0b3552c93fb8600"
|
|
170
|
+
},
|
|
171
|
+
{
|
|
172
|
+
"path": "AGENTS.md",
|
|
173
|
+
"category": "agent_doc",
|
|
174
|
+
"sha256": "9e33a1c20320e317e1e37dbb09fd0303e355b9e7d49cf2128fe791aaa2ce2fb1"
|
|
175
|
+
},
|
|
176
|
+
{
|
|
177
|
+
"path": "AGENT_START.md",
|
|
178
|
+
"category": "startup_doc",
|
|
179
|
+
"sha256": "ef8ec5feedbac948a1c63d14c5fff5bb41e3903d9de2c2b3e4db779278ff1b19"
|
|
180
|
+
},
|
|
181
|
+
{
|
|
182
|
+
"path": "CLAUDE.md",
|
|
183
|
+
"category": "agent_doc",
|
|
184
|
+
"sha256": "3ff3ec5560968f7f1bf6f7d34a3c4b6e636edc9f0d45f717cdebc4df3b76403a"
|
|
185
|
+
},
|
|
186
|
+
{
|
|
187
|
+
"path": "CLI_COMMAND_MATRIX.md",
|
|
188
|
+
"category": "startup_doc",
|
|
189
|
+
"sha256": "e39f45786eaf0cef07cc6fecd0c230474cfd7ee016a3736128566325cef73519"
|
|
190
|
+
},
|
|
191
|
+
{
|
|
192
|
+
"path": "llms.txt",
|
|
193
|
+
"category": "startup_doc",
|
|
194
|
+
"sha256": "8316bb8f634c6fb290ef1591e9c5b9786a2ddc06d25ab7d448fce8f4aebf65b8"
|
|
195
|
+
}
|
|
196
|
+
]
|
|
197
|
+
}
|
|
@@ -28,16 +28,17 @@ Finish work with evidence, validation, and minimal memory drift.
|
|
|
28
28
|
|
|
29
29
|
1. Run the relevant technical gates for the changed surface.
|
|
30
30
|
2. Run `mdkg validate` before closing the task.
|
|
31
|
-
3.
|
|
32
|
-
4. Use `mdkg task
|
|
33
|
-
5.
|
|
34
|
-
6.
|
|
35
|
-
7.
|
|
36
|
-
8.
|
|
37
|
-
9.
|
|
38
|
-
10.
|
|
39
|
-
11.
|
|
40
|
-
12. If
|
|
31
|
+
3. For mdkg scaffold or release work, include `mdkg upgrade` dry-run/apply evidence and any package smoke that exercises upgrade behavior.
|
|
32
|
+
4. Use `mdkg task update <id> ...` for additive evidence and structured metadata changes; keep narrative/body edits in markdown.
|
|
33
|
+
5. Use `mdkg task done <id> --checkpoint "<title>"` when the task should close with milestone compression.
|
|
34
|
+
6. Batch durable mdkg writes at one boundary: task status, artifact refs, optional checkpoint, and commit.
|
|
35
|
+
7. Mark tasks done only after evidence exists.
|
|
36
|
+
8. Create a checkpoint only for milestone-level transitions, not every small step.
|
|
37
|
+
9. For feat or epic closeout, prefer a checkpoint body as the durable narrative summary of what changed and what is next.
|
|
38
|
+
10. Use feat closeout scope as direct children with `parent: <feat-id>` and epic closeout scope as descendant work with `epic: <epic-id>`.
|
|
39
|
+
11. Parent status edits remain manual; do not invent a hidden parent-closeout workflow.
|
|
40
|
+
12. If the latest checkpoint is relevant, use it as durable recall; treat raw events as provenance/debugging, not primary execution context.
|
|
41
|
+
13. If `events.jsonl` is missing, recreate it with `mdkg event enable` before expecting automatic JSONL provenance.
|
|
41
42
|
|
|
42
43
|
## Outputs
|
|
43
44
|
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var __importDefault = (this && this.__importDefault) || function (mod) {
|
|
3
|
+
return (mod && mod.__esModule) ? mod : { "default": mod };
|
|
4
|
+
};
|
|
5
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
6
|
+
exports.BUILTIN_TEMPLATE_SET = void 0;
|
|
7
|
+
exports.templateNameForType = templateNameForType;
|
|
8
|
+
exports.resolveLocalTemplatePath = resolveLocalTemplatePath;
|
|
9
|
+
exports.resolveBundledTemplateRoot = resolveBundledTemplateRoot;
|
|
10
|
+
exports.resolveBundledTemplatePath = resolveBundledTemplatePath;
|
|
11
|
+
exports.requireBundledTemplatePath = requireBundledTemplatePath;
|
|
12
|
+
const fs_1 = __importDefault(require("fs"));
|
|
13
|
+
const path_1 = __importDefault(require("path"));
|
|
14
|
+
exports.BUILTIN_TEMPLATE_SET = "default";
|
|
15
|
+
function templateNameForType(type) {
|
|
16
|
+
const normalized = type.toLowerCase();
|
|
17
|
+
if (normalized === "checkpoint") {
|
|
18
|
+
return "chk";
|
|
19
|
+
}
|
|
20
|
+
return normalized;
|
|
21
|
+
}
|
|
22
|
+
function resolveLocalTemplatePath(root, config, type, templateSet) {
|
|
23
|
+
const setName = (templateSet ?? config.templates.default_set).toLowerCase();
|
|
24
|
+
return path_1.default.resolve(root, config.templates.root_path, setName, `${templateNameForType(type)}.md`);
|
|
25
|
+
}
|
|
26
|
+
function resolveBundledTemplateRoot() {
|
|
27
|
+
return path_1.default.resolve(__dirname, "..", "init", "templates", exports.BUILTIN_TEMPLATE_SET);
|
|
28
|
+
}
|
|
29
|
+
function resolveBundledTemplatePath(type) {
|
|
30
|
+
return path_1.default.join(resolveBundledTemplateRoot(), `${templateNameForType(type)}.md`);
|
|
31
|
+
}
|
|
32
|
+
function requireBundledTemplatePath(type) {
|
|
33
|
+
const templatePath = resolveBundledTemplatePath(type);
|
|
34
|
+
if (!fs_1.default.existsSync(templatePath)) {
|
|
35
|
+
throw new Error(`bundled template fallback missing for type ${type}: ${templatePath} (try reinstalling mdkg)`);
|
|
36
|
+
}
|
|
37
|
+
return templatePath;
|
|
38
|
+
}
|
package/dist/templates/loader.js
CHANGED
|
@@ -6,26 +6,19 @@ Object.defineProperty(exports, "__esModule", { value: true });
|
|
|
6
6
|
exports.loadTemplate = loadTemplate;
|
|
7
7
|
exports.renderTemplate = renderTemplate;
|
|
8
8
|
const fs_1 = __importDefault(require("fs"));
|
|
9
|
-
const path_1 = __importDefault(require("path"));
|
|
10
9
|
const frontmatter_1 = require("../graph/frontmatter");
|
|
11
10
|
const errors_1 = require("../util/errors");
|
|
12
|
-
|
|
13
|
-
const normalized = type.toLowerCase();
|
|
14
|
-
if (normalized === "checkpoint") {
|
|
15
|
-
return "chk";
|
|
16
|
-
}
|
|
17
|
-
return normalized;
|
|
18
|
-
}
|
|
11
|
+
const builtin_1 = require("./builtin");
|
|
19
12
|
function loadTemplate(root, config, type, templateSet) {
|
|
20
|
-
const
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
if (!fs_1.default.existsSync(templatePath)) {
|
|
24
|
-
throw new errors_1.NotFoundError(`template not found: ${setName}/${templateName}.md`);
|
|
13
|
+
const templatePath = (0, builtin_1.resolveLocalTemplatePath)(root, config, type, templateSet);
|
|
14
|
+
if (!fs_1.default.existsSync(templatePath) && templateSet !== undefined) {
|
|
15
|
+
throw new errors_1.NotFoundError(`template not found: ${templateSet.toLowerCase()}/${(0, builtin_1.templateNameForType)(type)}.md`);
|
|
25
16
|
}
|
|
26
|
-
const
|
|
27
|
-
const
|
|
28
|
-
|
|
17
|
+
const source = fs_1.default.existsSync(templatePath) ? "local" : "bundled";
|
|
18
|
+
const resolvedPath = source === "local" ? templatePath : (0, builtin_1.requireBundledTemplatePath)(type);
|
|
19
|
+
const content = fs_1.default.readFileSync(resolvedPath, "utf8");
|
|
20
|
+
const { frontmatter, body } = (0, frontmatter_1.parseFrontmatter)(content, resolvedPath);
|
|
21
|
+
return { templatePath: resolvedPath, source, frontmatter, body };
|
|
29
22
|
}
|
|
30
23
|
function isTokenPlaceholder(value) {
|
|
31
24
|
return typeof value === "string" && /^\{\{[a-z0-9_]+\}\}$/.test(value);
|
package/dist/util/argparse.js
CHANGED
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "mdkg",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.1.1",
|
|
4
4
|
"description": "Markdown Knowledge Graph",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"bin": {
|
|
@@ -13,10 +13,11 @@
|
|
|
13
13
|
"test:coverage": "npm run build && npm run build:test && node --test --experimental-test-coverage dist/tests/**/*.test.js",
|
|
14
14
|
"smoke:consumer": "npm run build && node scripts/smoke-consumer.js",
|
|
15
15
|
"smoke:matrix": "npm run build && node scripts/smoke-command-matrix.js",
|
|
16
|
+
"smoke:upgrade": "npm run build && node scripts/smoke-upgrade.js",
|
|
16
17
|
"cli:snapshot": "npm run build && node scripts/cli_help_snapshot.js",
|
|
17
18
|
"cli:check": "npm run build && node scripts/cli_help_snapshot.js --check",
|
|
18
19
|
"prepack": "npm run build && node scripts/assert-publish-ready.js",
|
|
19
|
-
"prepublishOnly": "npm run test && npm run cli:check && node dist/cli.js validate && npm run smoke:consumer && npm run smoke:matrix && node scripts/assert-publish-ready.js",
|
|
20
|
+
"prepublishOnly": "npm run test && npm run cli:check && node dist/cli.js validate && npm run smoke:consumer && npm run smoke:matrix && npm run smoke:upgrade && node scripts/assert-publish-ready.js",
|
|
20
21
|
"postinstall": "node scripts/postinstall.js"
|
|
21
22
|
},
|
|
22
23
|
"devDependencies": {
|