mdkg 0.4.0 → 0.4.1

package/dist/init/README.md

@@ -80,8 +80,9 @@ intentionally with `mdkg new task ...` or `mdkg new test ...`.
 Agent workflow docs can use semantic ids:
 
 ```bash
-mdkg new manifest "image worker" --id agent.image-worker
-mdkg new work "generate image" --id work.generate-image
+mdkg new manifest "image worker" --id agent.image-worker --contract-profile generic
+mdkg new work "generate image" --id work.generate-image --contract-profile generic
+mdkg work validate --profile omni-room --json
 ```
 
 `MANIFEST.md` is optional. Repos without manifest files still validate. When
@@ -92,6 +93,14 @@ release, and `mdkg spec list/show/validate` remains a deprecated alias for
 read-only discovery surface for skills, manifests, WORK contracts, core docs,
 and design docs.
 
+Agent workflow files may include optional generic mirror fields such as
+`contract_profile`, `validation_policy_ref`, `evidence_policy_ref`,
+`receipt_kind`, and `redaction_class`. mdkg validates those mirrors and can run
+profile checks such as `mdkg validate --profile omni-room` and
+`mdkg work validate --profile omni-room`; downstream runtimes still own queue
+execution, room ids, provider state, billing or ledger state, and final receipt
+authority.
+
 Read `AGENT_START.md` first when this repo includes it.
 
 ## Pack Profiles
@@ -229,10 +238,10 @@ mdkg archive verify archive://archive.example
 Use work lifecycle helpers for semantic mirrors only:
 
 ```bash
-mdkg work contract new "example capability" --id work.example --agent-id agent.example --kind example --inputs prompt:text:required --outputs result:text:required
+mdkg work contract new "example capability" --id work.example --agent-id agent.example --kind example --contract-profile generic --inputs prompt:text:required --outputs result:text:required
 mdkg work trigger work.example --id order.example-1 --requester user://example
 mdkg work order status order.example-1 --json
-mdkg work receipt new "example receipt" --id receipt.example-1 --work-order-id order.example-1 --outcome success
+mdkg work receipt new "example receipt" --id receipt.example-1 --work-order-id order.example-1 --outcome success --contract-profile generic --receipt-kind worker --redaction-class internal
 mdkg work receipt verify receipt.example-1 --json
 ```
 
@@ -249,7 +258,7 @@ Update and artifact commands accept local ids or local qids; subgraph qids are r
 `mdkg work trigger` creates a deterministic submitted `WORK_ORDER.md` from a
 WORK contract or a SPEC with exactly one resolvable work contract. `mdkg work
 order status` and `mdkg work receipt verify` are read-only review helpers.
-`mdkg work validate [<id-or-qid>] [--type spec|work|work_order|receipt|feedback|dispute|proposal] --json`
+`mdkg work validate [<id-or-qid>] [--type manifest|spec|work|work_order|receipt|feedback|dispute|proposal] [--profile omni-room] --json`
 is a read-only focused validator for agent workflow mirrors with typed diagnostics
 and raw secret, prompt, token, or payload marker warnings.
 `mdkg work trigger --enqueue <queue>` optionally writes a local project DB queue

package/dist/init/init-manifest.json

@@ -1,7 +1,7 @@
 {
   "schema_version": 1,
   "tool": "mdkg",
-  "mdkg_version": "0.4.0",
+  "mdkg_version": "0.4.1",
   "files": [
     {
       "path": ".mdkg/config.json",
@@ -66,12 +66,12 @@
     {
       "path": ".mdkg/README.md",
       "category": "mdkg_doc",
-      "sha256": "faaf4bb697eded7c6baf6cb44a2a6c04feabfc250cac3bcb4be6b95e7a3bb02a"
+      "sha256": "44e8030ee0642fe9c95589c2f4ece6ab7336d0c6691107bfdf59cebdba5de2ae"
     },
     {
       "path": ".mdkg/skills/author-mdkg-skill/SKILL.md",
       "category": "default_skill",
-      "sha256": "9ea196cb778e6a777c945b3bba9d51c7574602f413e9a1d5e01e2b95918c0873"
+      "sha256": "ffacd8b8412ab5453b53d91a192f27e0458da4591f80d82d4933805a6fb5a05d"
     },
     {
       "path": ".mdkg/skills/build-pack-and-execute-task/SKILL.md",
@@ -146,7 +146,7 @@
     {
       "path": ".mdkg/templates/default/manifest.md",
       "category": "template",
-      "sha256": "2ff2af58cae6a0381a66949d7d9e997fac6486da85171b09096c43663889da95"
+      "sha256": "a7d758cbe2a51c4889fef39bf91d67f67895f55bcd851d1e02e52f8b2a5a6f2c"
     },
     {
       "path": ".mdkg/templates/default/prd.md",
@@ -166,7 +166,7 @@
     {
       "path": ".mdkg/templates/default/receipt.md",
       "category": "template",
-      "sha256": "516faf98abe421f154d162b18006c7875f1a0025ac4d35cc16df744c13548d9d"
+      "sha256": "5ffbba7d9ad11193bf65830e4be5b3c04c0fe3aa81a4e473a849cd321644a383"
     },
     {
       "path": ".mdkg/templates/default/rule.md",
@@ -176,7 +176,7 @@
     {
       "path": ".mdkg/templates/default/spec.md",
       "category": "template",
-      "sha256": "8c96e0b6dafa65acb83a2d84519e05a7354896aec8991c148650e9ec58196c77"
+      "sha256": "2f00af67cf357f6a15a97bf175e6422d8c84d1fcf0e21977b1134e898378677e"
     },
     {
       "path": ".mdkg/templates/default/spike.md",
@@ -196,12 +196,12 @@
     {
       "path": ".mdkg/templates/default/work_order.md",
       "category": "template",
-      "sha256": "5fe376413035f2afe406d13491a597f103a2fce29d137951fe55ae042a1082f5"
+      "sha256": "d42460ae996f5f309d8666019c24d7b236947bc8a64cff6d4eff61b1d6e46216"
     },
     {
       "path": ".mdkg/templates/default/work.md",
       "category": "template",
-      "sha256": "cfc53d3be1d2c31576448d071a579bc3d5d2f6851755e29c20825f6b6764c0aa"
+      "sha256": "1ab3c4c79ecdaff2b76007bfbb9844bf581da592f70ac2a2475594b9c279d7cd"
     },
     {
       "path": ".mdkg/templates/skills/base.SKILL.md",
@@ -231,12 +231,12 @@
     {
       "path": ".mdkg/templates/specs/base.MANIFEST.md",
       "category": "template",
-      "sha256": "056c4ccf8285db72c8befdc6acd165d625dbe892d70e89ce586f081db8e250fc"
+      "sha256": "4d5fe98b388e9183c9577438e49c375e86d58314130c668be4695f124ea8c37c"
     },
     {
       "path": ".mdkg/templates/specs/base.SPEC.md",
       "category": "template",
-      "sha256": "6d4171fac00c2f3d8f2a2ac746b8a47c59aaecebe224c3a0046dd6e6974a1d08"
+      "sha256": "43d8b7726560c6245b2927ed5242dc872c394f16fb3dc9c3e58076766270ff5d"
     },
     {
       "path": ".mdkg/templates/specs/capability.MANIFEST.md",
@@ -311,7 +311,7 @@
     {
       "path": "AGENT_START.md",
       "category": "startup_doc",
-      "sha256": "91e31ae818b29f62ebe77ac24f7e1a2bd10a4fedfc1684da935f0849aaf6d200"
+      "sha256": "c387ce4fee55eafca09bcd30f32e4d7dc8ee7f9cc9811c1adffa0756c9423a35"
     },
     {
       "path": "AGENTS.md",
@@ -326,7 +326,7 @@
     {
       "path": "CLI_COMMAND_MATRIX.md",
       "category": "startup_doc",
-      "sha256": "82c509b91498131304ff2bc94bb7eb2f29c3c207a00bc8bcaf8a6ab52ff9e689"
+      "sha256": "7a71fa553e38395caae5f18ecb9650911c56a019b25e793addc20701e5df5a9e"
     },
     {
       "path": "llms.txt",

package/dist/init/skills/default/author-mdkg-skill/SKILL.md

@@ -62,6 +62,8 @@ For MANIFEST.md output, include:
 - Source mdkg nodes
 - Resource URIs
 - Capabilities
+- Contract profile, validation policy refs, and evidence policy refs when a
+  downstream runtime or workflow profile needs generic semantic mirrors
 - Inputs
 - Outputs
 - Dependencies
@@ -94,14 +96,17 @@ For MANIFEST.md output, include:
 10. Distinguish durable source from projection:
     mdkg/MANIFEST/SKILL is source; `.codex/agents`, future runtime manifests, and
     protocol resources are projections.
-11. Add validation checks and closeout evidence to every authored or revised
+11. Treat contract-profile fields as generic mdkg validation mirrors only.
+    Downstream runtimes own execution semantics, queue state, provider state, and
+    final receipt authority.
+12. Add validation checks and closeout evidence to every authored or revised
     SKILL/MANIFEST.
-12. If input is incomplete, create repair tasks instead of guessing.
-13. Validate the new or updated skill with `mdkg skill validate <slug>`.
-14. If the skill changes the public workflow, update `AGENT_START.md`,
+13. If input is incomplete, create repair tasks instead of guessing.
+14. Validate the new or updated skill with `mdkg skill validate <slug>`.
+15. If the skill changes the public workflow, update `AGENT_START.md`,
     `CLI_COMMAND_MATRIX.md`, root onboarding docs, and the skill registry in the
     same pass.
-15. When mirrored skill folders are enabled, run `mdkg skill sync` after broad
+16. When mirrored skill folders are enabled, run `mdkg skill sync` after broad
     manual changes so every configured `.mdkg/config.json`
     `customization.skill_mirrors.targets` path stays current. The default
     targets are `.agents/skills/` and `.claude/skills/`; other agent-local

package/dist/init/templates/default/manifest.md

@@ -7,6 +7,9 @@ spec_kind: capability
 role: tool_service
 runtime_mode: tool_service
 work_contracts: []
+contract_profile: generic
+validation_policy_ref: policy.validation.default
+evidence_policy_ref: policy.evidence.default
 requested_capabilities: []
 skill_refs: []
 tool_refs: []

package/dist/init/templates/default/receipt.md

@@ -8,6 +8,11 @@ receipt_status: recorded
 outcome: success
 cost_ref: cost.redacted
 redaction_policy: refs_and_hashes_only
+contract_profile: generic
+receipt_kind: worker
+redaction_class: internal
+validation_policy_ref: policy.validation.default
+evidence_policy_ref: policy.evidence.default
 proof_refs: []
 attestation_refs: []
 evidence_hashes: []

package/dist/init/templates/default/spec.md

@@ -7,6 +7,9 @@ spec_kind: capability
 role: tool_service
 runtime_mode: tool_service
 work_contracts: []
+contract_profile: generic
+validation_policy_ref: policy.validation.default
+evidence_policy_ref: policy.evidence.default
 requested_capabilities: []
 skill_refs: []
 tool_refs: []

package/dist/init/templates/default/work.md

@@ -5,6 +5,7 @@ title: {{title}}
 version: 0.1.0
 agent_id: agent.example
 kind: generic
+contract_profile: generic
 pricing_model: quoted
 required_capabilities: [capability.example]
 skill_refs: []

package/dist/init/templates/default/work_order.md

@@ -10,6 +10,9 @@ order_status: submitted
 request_ref: request.example
 trigger_ref: trigger.manual
 payload_hash: sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
+contract_profile: generic
+validation_policy_ref: policy.validation.default
+evidence_policy_ref: policy.evidence.default
 input_refs: []
 queue_refs: []
 requested_outputs: [result:text:required]

package/dist/init/templates/specs/base.MANIFEST.md

@@ -7,6 +7,9 @@ spec_kind: capability
 role: {{role}}
 runtime_mode: {{runtime_mode}}
 work_contracts: []
+contract_profile: generic
+validation_policy_ref: policy.validation.default
+evidence_policy_ref: policy.evidence.default
 requested_capabilities: []
 skill_refs: []
 tool_refs: []

package/dist/init/templates/specs/base.SPEC.md

@@ -7,6 +7,9 @@ spec_kind: capability
 role: {{role}}
 runtime_mode: {{runtime_mode}}
 work_contracts: []
+contract_profile: generic
+validation_policy_ref: policy.validation.default
+evidence_policy_ref: policy.evidence.default
 requested_capabilities: []
 skill_refs: []
 tool_refs: []

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mdkg",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Git-native project memory for AI coding agents",
   "license": "MIT",
   "bin": {