mdkg 0.4.0 → 0.4.2
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 +58 -0
- package/CLI_COMMAND_MATRIX.md +69 -9
- package/README.md +26 -2
- package/dist/cli.js +183 -8
- package/dist/command-contract.json +690 -24
- package/dist/commands/git.js +593 -0
- package/dist/commands/new.js +50 -1
- package/dist/commands/validate.js +84 -0
- package/dist/commands/work.js +45 -2
- package/dist/graph/agent_file_types.js +74 -2
- package/dist/graph/frontmatter.js +5 -0
- package/dist/graph/node.js +28 -0
- package/dist/init/AGENT_START.md +6 -0
- package/dist/init/CLI_COMMAND_MATRIX.md +10 -5
- package/dist/init/README.md +14 -5
- package/dist/init/init-manifest.json +12 -12
- package/dist/init/skills/default/author-mdkg-skill/SKILL.md +10 -5
- package/dist/init/templates/default/manifest.md +3 -0
- package/dist/init/templates/default/receipt.md +5 -0
- package/dist/init/templates/default/spec.md +3 -0
- package/dist/init/templates/default/work.md +1 -0
- package/dist/init/templates/default/work_order.md +3 -0
- package/dist/init/templates/specs/base.MANIFEST.md +3 -0
- package/dist/init/templates/specs/base.SPEC.md +3 -0
- package/dist/util/argparse.js +5 -0
- package/package.json +1 -1
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"schema_version": 1,
|
|
3
3
|
"tool": "mdkg",
|
|
4
|
-
"mdkg_version": "0.4.
|
|
4
|
+
"mdkg_version": "0.4.2",
|
|
5
5
|
"files": [
|
|
6
6
|
{
|
|
7
7
|
"path": ".mdkg/config.json",
|
|
@@ -66,12 +66,12 @@
|
|
|
66
66
|
{
|
|
67
67
|
"path": ".mdkg/README.md",
|
|
68
68
|
"category": "mdkg_doc",
|
|
69
|
-
"sha256": "
|
|
69
|
+
"sha256": "44e8030ee0642fe9c95589c2f4ece6ab7336d0c6691107bfdf59cebdba5de2ae"
|
|
70
70
|
},
|
|
71
71
|
{
|
|
72
72
|
"path": ".mdkg/skills/author-mdkg-skill/SKILL.md",
|
|
73
73
|
"category": "default_skill",
|
|
74
|
-
"sha256": "
|
|
74
|
+
"sha256": "ffacd8b8412ab5453b53d91a192f27e0458da4591f80d82d4933805a6fb5a05d"
|
|
75
75
|
},
|
|
76
76
|
{
|
|
77
77
|
"path": ".mdkg/skills/build-pack-and-execute-task/SKILL.md",
|
|
@@ -146,7 +146,7 @@
|
|
|
146
146
|
{
|
|
147
147
|
"path": ".mdkg/templates/default/manifest.md",
|
|
148
148
|
"category": "template",
|
|
149
|
-
"sha256": "
|
|
149
|
+
"sha256": "a7d758cbe2a51c4889fef39bf91d67f67895f55bcd851d1e02e52f8b2a5a6f2c"
|
|
150
150
|
},
|
|
151
151
|
{
|
|
152
152
|
"path": ".mdkg/templates/default/prd.md",
|
|
@@ -166,7 +166,7 @@
|
|
|
166
166
|
{
|
|
167
167
|
"path": ".mdkg/templates/default/receipt.md",
|
|
168
168
|
"category": "template",
|
|
169
|
-
"sha256": "
|
|
169
|
+
"sha256": "5ffbba7d9ad11193bf65830e4be5b3c04c0fe3aa81a4e473a849cd321644a383"
|
|
170
170
|
},
|
|
171
171
|
{
|
|
172
172
|
"path": ".mdkg/templates/default/rule.md",
|
|
@@ -176,7 +176,7 @@
|
|
|
176
176
|
{
|
|
177
177
|
"path": ".mdkg/templates/default/spec.md",
|
|
178
178
|
"category": "template",
|
|
179
|
-
"sha256": "
|
|
179
|
+
"sha256": "2f00af67cf357f6a15a97bf175e6422d8c84d1fcf0e21977b1134e898378677e"
|
|
180
180
|
},
|
|
181
181
|
{
|
|
182
182
|
"path": ".mdkg/templates/default/spike.md",
|
|
@@ -196,12 +196,12 @@
|
|
|
196
196
|
{
|
|
197
197
|
"path": ".mdkg/templates/default/work_order.md",
|
|
198
198
|
"category": "template",
|
|
199
|
-
"sha256": "
|
|
199
|
+
"sha256": "d42460ae996f5f309d8666019c24d7b236947bc8a64cff6d4eff61b1d6e46216"
|
|
200
200
|
},
|
|
201
201
|
{
|
|
202
202
|
"path": ".mdkg/templates/default/work.md",
|
|
203
203
|
"category": "template",
|
|
204
|
-
"sha256": "
|
|
204
|
+
"sha256": "1ab3c4c79ecdaff2b76007bfbb9844bf581da592f70ac2a2475594b9c279d7cd"
|
|
205
205
|
},
|
|
206
206
|
{
|
|
207
207
|
"path": ".mdkg/templates/skills/base.SKILL.md",
|
|
@@ -231,12 +231,12 @@
|
|
|
231
231
|
{
|
|
232
232
|
"path": ".mdkg/templates/specs/base.MANIFEST.md",
|
|
233
233
|
"category": "template",
|
|
234
|
-
"sha256": "
|
|
234
|
+
"sha256": "4d5fe98b388e9183c9577438e49c375e86d58314130c668be4695f124ea8c37c"
|
|
235
235
|
},
|
|
236
236
|
{
|
|
237
237
|
"path": ".mdkg/templates/specs/base.SPEC.md",
|
|
238
238
|
"category": "template",
|
|
239
|
-
"sha256": "
|
|
239
|
+
"sha256": "43d8b7726560c6245b2927ed5242dc872c394f16fb3dc9c3e58076766270ff5d"
|
|
240
240
|
},
|
|
241
241
|
{
|
|
242
242
|
"path": ".mdkg/templates/specs/capability.MANIFEST.md",
|
|
@@ -311,7 +311,7 @@
|
|
|
311
311
|
{
|
|
312
312
|
"path": "AGENT_START.md",
|
|
313
313
|
"category": "startup_doc",
|
|
314
|
-
"sha256": "
|
|
314
|
+
"sha256": "c387ce4fee55eafca09bcd30f32e4d7dc8ee7f9cc9811c1adffa0756c9423a35"
|
|
315
315
|
},
|
|
316
316
|
{
|
|
317
317
|
"path": "AGENTS.md",
|
|
@@ -326,7 +326,7 @@
|
|
|
326
326
|
{
|
|
327
327
|
"path": "CLI_COMMAND_MATRIX.md",
|
|
328
328
|
"category": "startup_doc",
|
|
329
|
-
"sha256": "
|
|
329
|
+
"sha256": "7a71fa553e38395caae5f18ecb9650911c56a019b25e793addc20701e5df5a9e"
|
|
330
330
|
},
|
|
331
331
|
{
|
|
332
332
|
"path": "llms.txt",
|
|
@@ -62,6 +62,8 @@ For MANIFEST.md output, include:
|
|
|
62
62
|
- Source mdkg nodes
|
|
63
63
|
- Resource URIs
|
|
64
64
|
- Capabilities
|
|
65
|
+
- Contract profile, validation policy refs, and evidence policy refs when a
|
|
66
|
+
downstream runtime or workflow profile needs generic semantic mirrors
|
|
65
67
|
- Inputs
|
|
66
68
|
- Outputs
|
|
67
69
|
- Dependencies
|
|
@@ -94,14 +96,17 @@ For MANIFEST.md output, include:
|
|
|
94
96
|
10. Distinguish durable source from projection:
|
|
95
97
|
mdkg/MANIFEST/SKILL is source; `.codex/agents`, future runtime manifests, and
|
|
96
98
|
protocol resources are projections.
|
|
97
|
-
11.
|
|
99
|
+
11. Treat contract-profile fields as generic mdkg validation mirrors only.
|
|
100
|
+
Downstream runtimes own execution semantics, queue state, provider state, and
|
|
101
|
+
final receipt authority.
|
|
102
|
+
12. Add validation checks and closeout evidence to every authored or revised
|
|
98
103
|
SKILL/MANIFEST.
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
104
|
+
13. If input is incomplete, create repair tasks instead of guessing.
|
|
105
|
+
14. Validate the new or updated skill with `mdkg skill validate <slug>`.
|
|
106
|
+
15. If the skill changes the public workflow, update `AGENT_START.md`,
|
|
102
107
|
`CLI_COMMAND_MATRIX.md`, root onboarding docs, and the skill registry in the
|
|
103
108
|
same pass.
|
|
104
|
-
|
|
109
|
+
16. When mirrored skill folders are enabled, run `mdkg skill sync` after broad
|
|
105
110
|
manual changes so every configured `.mdkg/config.json`
|
|
106
111
|
`customization.skill_mirrors.targets` path stays current. The default
|
|
107
112
|
targets are `.agents/skills/` and `.claude/skills/`; other agent-local
|
|
@@ -7,6 +7,9 @@ spec_kind: capability
|
|
|
7
7
|
role: tool_service
|
|
8
8
|
runtime_mode: tool_service
|
|
9
9
|
work_contracts: []
|
|
10
|
+
contract_profile: generic
|
|
11
|
+
validation_policy_ref: policy.validation.default
|
|
12
|
+
evidence_policy_ref: policy.evidence.default
|
|
10
13
|
requested_capabilities: []
|
|
11
14
|
skill_refs: []
|
|
12
15
|
tool_refs: []
|
|
@@ -8,6 +8,11 @@ receipt_status: recorded
|
|
|
8
8
|
outcome: success
|
|
9
9
|
cost_ref: cost.redacted
|
|
10
10
|
redaction_policy: refs_and_hashes_only
|
|
11
|
+
contract_profile: generic
|
|
12
|
+
receipt_kind: worker
|
|
13
|
+
redaction_class: internal
|
|
14
|
+
validation_policy_ref: policy.validation.default
|
|
15
|
+
evidence_policy_ref: policy.evidence.default
|
|
11
16
|
proof_refs: []
|
|
12
17
|
attestation_refs: []
|
|
13
18
|
evidence_hashes: []
|
|
@@ -7,6 +7,9 @@ spec_kind: capability
|
|
|
7
7
|
role: tool_service
|
|
8
8
|
runtime_mode: tool_service
|
|
9
9
|
work_contracts: []
|
|
10
|
+
contract_profile: generic
|
|
11
|
+
validation_policy_ref: policy.validation.default
|
|
12
|
+
evidence_policy_ref: policy.evidence.default
|
|
10
13
|
requested_capabilities: []
|
|
11
14
|
skill_refs: []
|
|
12
15
|
tool_refs: []
|
|
@@ -10,6 +10,9 @@ order_status: submitted
|
|
|
10
10
|
request_ref: request.example
|
|
11
11
|
trigger_ref: trigger.manual
|
|
12
12
|
payload_hash: sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
|
|
13
|
+
contract_profile: generic
|
|
14
|
+
validation_policy_ref: policy.validation.default
|
|
15
|
+
evidence_policy_ref: policy.evidence.default
|
|
13
16
|
input_refs: []
|
|
14
17
|
queue_refs: []
|
|
15
18
|
requested_outputs: [result:text:required]
|
|
@@ -7,6 +7,9 @@ spec_kind: capability
|
|
|
7
7
|
role: {{role}}
|
|
8
8
|
runtime_mode: {{runtime_mode}}
|
|
9
9
|
work_contracts: []
|
|
10
|
+
contract_profile: generic
|
|
11
|
+
validation_policy_ref: policy.validation.default
|
|
12
|
+
evidence_policy_ref: policy.evidence.default
|
|
10
13
|
requested_capabilities: []
|
|
11
14
|
skill_refs: []
|
|
12
15
|
tool_refs: []
|
|
@@ -7,6 +7,9 @@ spec_kind: capability
|
|
|
7
7
|
role: {{role}}
|
|
8
8
|
runtime_mode: {{runtime_mode}}
|
|
9
9
|
work_contracts: []
|
|
10
|
+
contract_profile: generic
|
|
11
|
+
validation_policy_ref: policy.validation.default
|
|
12
|
+
evidence_policy_ref: policy.evidence.default
|
|
10
13
|
requested_capabilities: []
|
|
11
14
|
skill_refs: []
|
|
12
15
|
tool_refs: []
|
package/dist/util/argparse.js
CHANGED
|
@@ -92,7 +92,11 @@ const VALUE_FLAGS = new Set([
|
|
|
92
92
|
"--visibility",
|
|
93
93
|
"--source-path",
|
|
94
94
|
"--source-repo",
|
|
95
|
+
"--remote",
|
|
96
|
+
"--branch",
|
|
97
|
+
"--message",
|
|
95
98
|
"--max-stale-seconds",
|
|
99
|
+
"--queue-policy",
|
|
96
100
|
"--requires",
|
|
97
101
|
"--target",
|
|
98
102
|
"--snapshot",
|
|
@@ -138,6 +142,7 @@ const BOOLEAN_FLAGS = new Set([
|
|
|
138
142
|
"--clean",
|
|
139
143
|
"--gitignore",
|
|
140
144
|
"--select-goal",
|
|
145
|
+
"--stage-all",
|
|
141
146
|
"--stdio",
|
|
142
147
|
]);
|
|
143
148
|
const FLAG_ALIASES = {
|