feat(m0.6-r6): release examples, public schemas and cross-platform CI

- add runnable examples for an unknown-name Tool, multi-export plugin,
  external kernel provider and same-name multi-version packages
- add JSON Schemas for Analysis v1, Trace v1 and Tool v1 and validate them in CI
- extend CI with protocol/consumer smoke tests and a Windows/macOS cargo check
- add --kernel provider descriptors and R6 example integration tests
- document the examples and update M0.6 status
This commit is contained in:
cflmy committed 2026-11-20 11:50:27 +08:00
1 parent 54c7b43d15
commit 4ce37afb39
31 files changed
+537 -5

No files matched your search

+52
View File
@@ -0,0 +1,52 @@
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://marqdo.dev/schemas/analysis-v1.schema.json",
"title": "Marqdo Analysis v1",
"type": "object",
"required": ["schema", "schema_version", "producer", "project", "modules", "diagnostics"],
"properties": {
"schema": {"const": "marqdo.analysis"},
"schema_version": {"const": 1},
"producer": {
"type": "object",
"required": ["name", "version", "markdown_profile"],
"properties": {
"name": {"type": "string"},
"version": {"type": "string"},
"markdown_profile": {"const": "marqdo.md.v1"}
},
"additionalProperties": true
},
"project": {
"type": "object",
"required": ["root_id", "lock_digest"],
"properties": {
"root_id": {"type": "string"},
"lock_digest": {"type": "string"}
},
"additionalProperties": true
},
"modules": {
"type": "array",
"items": {
"type": "object",
"required": ["id", "package_instance_id", "relative_path", "source_digest", "units", "functions", "imports", "references", "calls"],
"properties": {
"id": {"type": "string", "pattern": "::"},
"package_instance_id": {"type": "string"},
"relative_path": {"type": "string"},
"source_digest": {"type": "string", "pattern": "^[0-9a-f]{64}$"},
"units": {"type": "array"},
"functions": {"type": "array"},
"imports": {"type": "array"},
"references": {"type": "array"},
"calls": {"type": "array"},
"resources": {"type": "integer", "minimum": 0}
},
"additionalProperties": true
}
},
"diagnostics": {"type": "array"}
},
"additionalProperties": true
}
+25
View File
@@ -0,0 +1,25 @@
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://marqdo.dev/schemas/tool-v1.schema.json",
"title": "Marqdo CLI Tool Manifest v1",
"type": "object",
"required": ["schema", "schema_version", "name", "version", "command", "entrypoint"],
"properties": {
"schema": {"const": "marqdo.cli-tool"},
"schema_version": {"const": 1},
"name": {"type": "string", "minLength": 1},
"version": {"type": "string", "minLength": 1},
"command": {"type": "string", "pattern": "^[a-z][a-z0-9-]*$"},
"entrypoint": {"type": "string", "minLength": 1},
"compatibility": {
"type": "object",
"properties": {
"marqdo": {"type": "string"},
"analysis": {"type": "array", "items": {"type": "integer", "minimum": 1}},
"trace": {"type": "array", "items": {"type": "integer", "minimum": 1}}
},
"additionalProperties": true
}
},
"additionalProperties": true
}
+55
View File
@@ -0,0 +1,55 @@
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://marqdo.dev/schemas/trace-v1.schema.json",
"title": "Marqdo Trace v1",
"type": "object",
"required": ["schema", "schema_version", "run", "source", "events"],
"properties": {
"schema": {"const": "marqdo.trace"},
"schema_version": {"const": 1},
"run": {
"type": "object",
"required": ["id", "entry", "status"],
"properties": {
"id": {"type": "string"},
"entry": {"type": "string"},
"status": {"type": "string"}
},
"additionalProperties": true
},
"source": {
"type": "object",
"required": ["root_id", "analysis_digest"],
"properties": {
"root_id": {"type": "string"},
"analysis_digest": {"type": "string"}
},
"additionalProperties": true
},
"events": {
"type": "array",
"items": {
"type": "object",
"required": ["seq", "kind"],
"properties": {
"seq": {"type": "integer", "minimum": 0},
"kind": {"type": "string"},
"function_id": {"type": ["string", "null"]},
"module": {"type": ["string", "null"]},
"span": {
"type": ["object", "null"],
"properties": {
"start": {"type": "integer", "minimum": 0},
"end": {"type": "integer", "minimum": 0}
}
},
"detail": {"type": ["string", "null"]},
"operation": {"type": "string"},
"duration_micros": {"type": "integer", "minimum": 0}
},
"additionalProperties": true
}
}
},
"additionalProperties": true
}