Files
dingtalk-workspace-cli/internal/cli/schema_catalog/tools/audit.json
T
玉澜 51dc237d8a feat: declarative LeafSpec command framework + schema generation/consumption separation
== LeafSpec command framework (internal/helpers/leaf.go) ==
Declarative command construction: LeafSpec/LeafFlag/NewLeafCommand with
Call (pluggable dispatch), LeafInt, PostMount, Trim, Validate. Collapses
per-command hand-written required validation, alias/env fallback, value
transform, and toolArgs assembly into one declarative path.

== devapp migration (28/31 commands) ==
All MCP-direct devapp leaf commands migrated to LeafSpec. Factories
(devAppCall/devAppCallCursor/devAppMeta) fold 33 repeated closures.
fakeDevAppRunner asserts toolArgs for every migrated command. 4 complex
commands (delete/robot submit/result/config) kept hand-written.

== Schema generation/consumption separation ==
- gen.go: isolated //go:generate pragmas from business code.
- command_meta.go: ResolveMeta(cliPath) -> CommandMeta{Identity,Safety,Selection}.
- command_safety.go: SafetyForCLIPath + RenderSafetyAnnotation; safety metadata
  flows from embedded catalog into --help output.
- calendar.go HelpFunc fix: delegates to root HelpFunc at help-time.
- schema_catalog_structure.go: closed catalog structure validation gate.

== Registry + catalog per-product sharding ==
schema_command_registry and schema_catalog split into per-product shards,
eliminating concurrent-PR merge conflicts on these files.

== MCP metadata refresh tool ==
cmd/fetch_mcp_metadata: iterates 26 MCP server endpoints, merges with previous
data for cross-server interface_ref. make fetch-mcp-metadata target.

== AGENTS.md ==
Documents the generation/consumption split.

Verified: make policy exit 0, drift zero, all tests pass.
2026-07-19 09:38:43 +08:00

1418 lines
52 KiB
JSON
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
{
"product": "audit",
"tools": {
"audit.export": {
"agent_metadata_source": "embedded-skill-metadata",
"agent_source_refs": [
"cobra-help:dws audit export --help",
"internal/app/audit_command.go",
"internal/cli/schema_command_registry.json#audit.export",
"internal/cli/schema_hints/metadata/audit.json",
"internal/cli/schema_hints/selection/audit.json"
],
"agent_summary": "按日期范围导出本地操作审计日志(jsonl 或 csv)",
"agent_summary_source": "dws-agent-selection/audit",
"availability": "available",
"avoid_when": [
"只看最近几条用 audit tail",
"只校验哈希链完整性用 audit verify"
],
"canonical_path": "audit.export",
"cli_name": "export",
"cli_path": "audit export",
"confirmation": "not_required",
"description": "导出审计日志",
"display": "操作审计日志管理",
"effect": "read",
"effect_source": "agent-hint",
"examples": [
"dws audit export --format jsonl",
"dws audit export --since 2026-07-01 --until 2026-07-14 --format csv"
],
"field_provenance": {
"agent_summary": {
"candidates": [
{
"precedence": "reviewed_explicit",
"review_reason": "纳入 #555 公开 audit leaf 的 Agent 选型文案;本地只读导出,示例不含 --yes。",
"selected": true,
"source": "internal/cli/schema_hints/selection/audit.json",
"value": "按日期范围导出本地操作审计日志(jsonl 或 csv)"
}
],
"precedence": "reviewed_explicit",
"resolution": "highest_precedence",
"review_reason": "纳入 #555 公开 audit leaf 的 Agent 选型文案;本地只读导出,示例不含 --yes。",
"source": "internal/cli/schema_hints/selection/audit.json",
"value": "按日期范围导出本地操作审计日志(jsonl 或 csv)"
},
"availability": {
"candidates": [
{
"precedence": "reviewed_explicit",
"review_reason": "Local audit log export from #555; no remote RPC.",
"selected": true,
"source": "internal/cli/schema_hints/metadata/audit.json",
"value": "available"
}
],
"precedence": "reviewed_explicit",
"resolution": "highest_precedence",
"review_reason": "Local audit log export from #555; no remote RPC.",
"source": "internal/cli/schema_hints/metadata/audit.json",
"value": "available"
},
"avoid_when": {
"candidates": [
{
"precedence": "reviewed_explicit",
"review_reason": "纳入 #555 公开 audit leaf 的 Agent 选型文案;本地只读导出,示例不含 --yes。",
"selected": true,
"source": "internal/cli/schema_hints/selection/audit.json",
"value": [
"只看最近几条用 audit tail",
"只校验哈希链完整性用 audit verify"
]
}
],
"precedence": "reviewed_explicit",
"resolution": "highest_precedence",
"review_reason": "纳入 #555 公开 audit leaf 的 Agent 选型文案;本地只读导出,示例不含 --yes。",
"source": "internal/cli/schema_hints/selection/audit.json",
"value": [
"只看最近几条用 audit tail",
"只校验哈希链完整性用 audit verify"
]
},
"canonical_path": {
"candidates": [
{
"precedence": "command_registry",
"selected": true,
"source": "reviewed_command_registry",
"source_ref": "audit export",
"value": "audit.export"
}
],
"precedence": "command_registry",
"resolution": "registry_identity",
"source": "reviewed_command_registry",
"source_ref": "audit export",
"value": "audit.export"
},
"confirmation": {
"candidates": [
{
"precedence": "reviewed_explicit",
"review_reason": "Local audit log export from #555; no remote RPC.",
"selected": true,
"source": "internal/cli/schema_hints/metadata/audit.json",
"value": "not_required"
}
],
"precedence": "reviewed_explicit",
"resolution": "highest_precedence",
"review_reason": "Local audit log export from #555; no remote RPC.",
"source": "internal/cli/schema_hints/metadata/audit.json",
"value": "not_required"
},
"description": {
"candidates": [
{
"precedence": "cobra_help",
"selected": true,
"source": "cobra_help",
"value": "导出审计日志"
}
],
"precedence": "cobra_help",
"resolution": "highest_precedence",
"source": "cobra_help",
"value": "导出审计日志"
},
"effect": {
"candidates": [
{
"precedence": "reviewed_explicit",
"review_reason": "Local audit log export from #555; no remote RPC.",
"selected": true,
"source": "internal/cli/schema_hints/metadata/audit.json",
"value": "read"
}
],
"precedence": "reviewed_explicit",
"resolution": "highest_precedence",
"review_reason": "Local audit log export from #555; no remote RPC.",
"source": "internal/cli/schema_hints/metadata/audit.json",
"value": "read"
},
"examples": {
"candidates": [
{
"precedence": "reviewed_explicit",
"review_reason": "纳入 #555 公开 audit leaf 的 Agent 选型文案;本地只读导出,示例不含 --yes。",
"selected": true,
"source": "internal/cli/schema_hints/selection/audit.json",
"value": [
"dws audit export --format jsonl",
"dws audit export --since 2026-07-01 --until 2026-07-14 --format csv"
]
}
],
"precedence": "reviewed_explicit",
"resolution": "highest_precedence",
"review_reason": "纳入 #555 公开 audit leaf 的 Agent 选型文案;本地只读导出,示例不含 --yes。",
"source": "internal/cli/schema_hints/selection/audit.json",
"value": [
"dws audit export --format jsonl",
"dws audit export --since 2026-07-01 --until 2026-07-14 --format csv"
]
},
"idempotency": {
"candidates": [
{
"precedence": "reviewed_explicit",
"review_reason": "Local audit log export from #555; no remote RPC.",
"selected": true,
"source": "internal/cli/schema_hints/metadata/audit.json",
"value": "idempotent"
}
],
"precedence": "reviewed_explicit",
"resolution": "highest_precedence",
"review_reason": "Local audit log export from #555; no remote RPC.",
"source": "internal/cli/schema_hints/metadata/audit.json",
"value": "idempotent"
},
"interface_mode": {
"candidates": [
{
"precedence": "reviewed_explicit",
"review_reason": "Local audit log export from #555; no remote RPC.",
"selected": true,
"source": "internal/cli/schema_hints/metadata/audit.json",
"value": "local"
}
],
"precedence": "reviewed_explicit",
"resolution": "highest_precedence",
"review_reason": "Local audit log export from #555; no remote RPC.",
"source": "internal/cli/schema_hints/metadata/audit.json",
"value": "local"
},
"interface_reason": {
"candidates": [
{
"precedence": "reviewed_explicit",
"review_reason": "Local audit log export from #555; no remote RPC.",
"selected": true,
"source": "internal/cli/schema_hints/metadata/audit.json",
"value": "命令读取并导出本地审计日志文件,不绑定 pinned MCP RPC"
}
],
"precedence": "reviewed_explicit",
"resolution": "highest_precedence",
"review_reason": "Local audit log export from #555; no remote RPC.",
"source": "internal/cli/schema_hints/metadata/audit.json",
"value": "命令读取并导出本地审计日志文件,不绑定 pinned MCP RPC"
},
"interface_ref": {
"candidates": [
{
"precedence": "reviewed_explicit",
"review_reason": "final interface mode local forbids a direct MCP interface_ref",
"selected": true,
"source": "internal/cli/schema_hints/metadata/audit.json",
"value": null
}
],
"precedence": "reviewed_explicit",
"resolution": "interface_disposition_matrix",
"review_reason": "final interface mode local forbids a direct MCP interface_ref",
"source": "internal/cli/schema_hints/metadata/audit.json",
"value": null
},
"reviewed": {
"candidates": [
{
"precedence": "reviewed_explicit",
"review_reason": "Local audit log export from #555; no remote RPC.",
"selected": true,
"source": "internal/cli/schema_hints/metadata/audit.json",
"value": true
},
{
"precedence": "reviewed_explicit",
"review_reason": "纳入 #555 公开 audit leaf 的 Agent 选型文案;本地只读导出,示例不含 --yes。",
"selected": false,
"source": "internal/cli/schema_hints/selection/audit.json",
"value": true
}
],
"precedence": "reviewed_explicit",
"resolution": "highest_precedence",
"review_reason": "Local audit log export from #555; no remote RPC.",
"source": "internal/cli/schema_hints/metadata/audit.json",
"value": true
},
"risk": {
"candidates": [
{
"precedence": "reviewed_explicit",
"review_reason": "Local audit log export from #555; no remote RPC.",
"selected": true,
"source": "internal/cli/schema_hints/metadata/audit.json",
"value": "low"
}
],
"precedence": "reviewed_explicit",
"resolution": "highest_precedence",
"review_reason": "Local audit log export from #555; no remote RPC.",
"source": "internal/cli/schema_hints/metadata/audit.json",
"value": "low"
},
"title": {
"candidates": [
{
"precedence": "cobra_help",
"selected": true,
"source": "cobra_help",
"value": "导出审计日志"
}
],
"precedence": "cobra_help",
"resolution": "highest_precedence",
"source": "cobra_help",
"value": "导出审计日志"
},
"use_when": {
"candidates": [
{
"precedence": "reviewed_explicit",
"review_reason": "纳入 #555 公开 audit leaf 的 Agent 选型文案;本地只读导出,示例不含 --yes。",
"selected": true,
"source": "internal/cli/schema_hints/selection/audit.json",
"value": [
"需要把本地审计日志导出为 jsonl/csv,或按 --since/--until 取一段时间"
]
}
],
"precedence": "reviewed_explicit",
"resolution": "highest_precedence",
"review_reason": "纳入 #555 公开 audit leaf 的 Agent 选型文案;本地只读导出,示例不含 --yes。",
"source": "internal/cli/schema_hints/selection/audit.json",
"value": [
"需要把本地审计日志导出为 jsonl/csv,或按 --since/--until 取一段时间"
]
}
},
"has_parameters": true,
"idempotency": "idempotent",
"interface_mode": "local",
"interface_reason": "命令读取并导出本地审计日志文件,不绑定 pinned MCP RPC",
"is_alias": false,
"name": "export",
"parameter_count": 3,
"parameters": {
"format": {
"default": "jsonl",
"description": "输出格式: jsonl 或 csv",
"field_provenance": {
"description": {
"candidates": [
{
"precedence": "cobra_contract",
"selected": true,
"source": "cobra_usage",
"value": "输出格式: jsonl 或 csv"
},
{
"precedence": "default",
"selected": false,
"source": "default",
"value": ""
}
],
"precedence": "cobra_contract",
"resolution": "highest_precedence",
"source": "cobra_usage",
"value": "输出格式: jsonl 或 csv"
},
"property": {
"candidates": [
{
"precedence": "inference",
"selected": true,
"source": "flag_name_inference",
"value": "format"
}
],
"precedence": "inference",
"resolution": "highest_precedence",
"source": "flag_name_inference",
"value": "format"
},
"required": {
"candidates": [
{
"precedence": "cobra_contract",
"selected": true,
"source": "cobra_nonzero_default",
"value": false
},
{
"precedence": "default",
"selected": false,
"source": "default",
"value": false
}
],
"precedence": "cobra_contract",
"resolution": "highest_precedence",
"source": "cobra_nonzero_default",
"value": false
},
"required_when": {
"candidates": [
{
"precedence": "default",
"selected": true,
"source": "default",
"value": ""
}
],
"precedence": "default",
"resolution": "highest_precedence",
"source": "default",
"value": ""
},
"type": {
"candidates": [
{
"precedence": "cobra_contract",
"selected": true,
"source": "cobra_flag_type",
"value": "string"
}
],
"precedence": "cobra_contract",
"resolution": "highest_precedence",
"source": "cobra_flag_type",
"value": "string"
}
},
"property": "format",
"required": false,
"type": "string"
},
"since": {
"description": "起始日期 (YYYY-MM-DD)",
"field_provenance": {
"description": {
"candidates": [
{
"precedence": "cobra_contract",
"selected": true,
"source": "cobra_usage",
"value": "起始日期 (YYYY-MM-DD)"
},
{
"precedence": "default",
"selected": false,
"source": "default",
"value": ""
}
],
"precedence": "cobra_contract",
"resolution": "highest_precedence",
"source": "cobra_usage",
"value": "起始日期 (YYYY-MM-DD)"
},
"property": {
"candidates": [
{
"precedence": "inference",
"selected": true,
"source": "flag_name_inference",
"value": "since"
}
],
"precedence": "inference",
"resolution": "highest_precedence",
"source": "flag_name_inference",
"value": "since"
},
"required": {
"candidates": [
{
"precedence": "default",
"selected": true,
"source": "default",
"value": false
}
],
"precedence": "default",
"resolution": "fallback",
"source": "default",
"value": false
},
"required_when": {
"candidates": [
{
"precedence": "default",
"selected": true,
"source": "default",
"value": ""
}
],
"precedence": "default",
"resolution": "highest_precedence",
"source": "default",
"value": ""
},
"type": {
"candidates": [
{
"precedence": "cobra_contract",
"selected": true,
"source": "cobra_flag_type",
"value": "string"
}
],
"precedence": "cobra_contract",
"resolution": "highest_precedence",
"source": "cobra_flag_type",
"value": "string"
}
},
"property": "since",
"required": false,
"type": "string"
},
"until": {
"description": "截止日期 (YYYY-MM-DD)",
"field_provenance": {
"description": {
"candidates": [
{
"precedence": "cobra_contract",
"selected": true,
"source": "cobra_usage",
"value": "截止日期 (YYYY-MM-DD)"
},
{
"precedence": "default",
"selected": false,
"source": "default",
"value": ""
}
],
"precedence": "cobra_contract",
"resolution": "highest_precedence",
"source": "cobra_usage",
"value": "截止日期 (YYYY-MM-DD)"
},
"property": {
"candidates": [
{
"precedence": "inference",
"selected": true,
"source": "flag_name_inference",
"value": "until"
}
],
"precedence": "inference",
"resolution": "highest_precedence",
"source": "flag_name_inference",
"value": "until"
},
"required": {
"candidates": [
{
"precedence": "default",
"selected": true,
"source": "default",
"value": false
}
],
"precedence": "default",
"resolution": "fallback",
"source": "default",
"value": false
},
"required_when": {
"candidates": [
{
"precedence": "default",
"selected": true,
"source": "default",
"value": ""
}
],
"precedence": "default",
"resolution": "highest_precedence",
"source": "default",
"value": ""
},
"type": {
"candidates": [
{
"precedence": "cobra_contract",
"selected": true,
"source": "cobra_flag_type",
"value": "string"
}
],
"precedence": "cobra_contract",
"resolution": "highest_precedence",
"source": "cobra_flag_type",
"value": "string"
}
},
"property": "until",
"required": false,
"type": "string"
}
},
"path": "audit.export",
"primary_cli_path": "audit export",
"product_id": "audit",
"reviewed": true,
"risk": "low",
"source": "reviewed_command_registry",
"title": "导出审计日志",
"use_when": [
"需要把本地审计日志导出为 jsonl/csv,或按 --since/--until 取一段时间"
]
},
"audit.tail": {
"agent_metadata_source": "embedded-skill-metadata",
"agent_source_refs": [
"cobra-help:dws audit tail --help",
"internal/app/audit_command.go",
"internal/cli/schema_command_registry.json#audit.tail",
"internal/cli/schema_hints/metadata/audit.json",
"internal/cli/schema_hints/selection/audit.json"
],
"agent_summary": "查看本地操作审计日志最近 N 条记录",
"agent_summary_source": "dws-agent-selection/audit",
"availability": "available",
"avoid_when": [
"需要按日期范围整段导出用 audit export",
"需要校验哈希链用 audit verify"
],
"canonical_path": "audit.tail",
"cli_name": "tail",
"cli_path": "audit tail",
"confirmation": "not_required",
"description": "查看最近的审计记录",
"display": "操作审计日志管理",
"effect": "read",
"effect_source": "agent-hint",
"examples": [
"dws audit tail",
"dws audit tail --lines 50"
],
"field_provenance": {
"agent_summary": {
"candidates": [
{
"precedence": "reviewed_explicit",
"review_reason": "纳入 #555 公开 audit leaf 的 Agent 选型文案;本地只读查看,示例不含 --yes。",
"selected": true,
"source": "internal/cli/schema_hints/selection/audit.json",
"value": "查看本地操作审计日志最近 N 条记录"
}
],
"precedence": "reviewed_explicit",
"resolution": "highest_precedence",
"review_reason": "纳入 #555 公开 audit leaf 的 Agent 选型文案;本地只读查看,示例不含 --yes。",
"source": "internal/cli/schema_hints/selection/audit.json",
"value": "查看本地操作审计日志最近 N 条记录"
},
"availability": {
"candidates": [
{
"precedence": "reviewed_explicit",
"review_reason": "Local audit log tail from #555; no remote RPC.",
"selected": true,
"source": "internal/cli/schema_hints/metadata/audit.json",
"value": "available"
}
],
"precedence": "reviewed_explicit",
"resolution": "highest_precedence",
"review_reason": "Local audit log tail from #555; no remote RPC.",
"source": "internal/cli/schema_hints/metadata/audit.json",
"value": "available"
},
"avoid_when": {
"candidates": [
{
"precedence": "reviewed_explicit",
"review_reason": "纳入 #555 公开 audit leaf 的 Agent 选型文案;本地只读查看,示例不含 --yes。",
"selected": true,
"source": "internal/cli/schema_hints/selection/audit.json",
"value": [
"需要按日期范围整段导出用 audit export",
"需要校验哈希链用 audit verify"
]
}
],
"precedence": "reviewed_explicit",
"resolution": "highest_precedence",
"review_reason": "纳入 #555 公开 audit leaf 的 Agent 选型文案;本地只读查看,示例不含 --yes。",
"source": "internal/cli/schema_hints/selection/audit.json",
"value": [
"需要按日期范围整段导出用 audit export",
"需要校验哈希链用 audit verify"
]
},
"canonical_path": {
"candidates": [
{
"precedence": "command_registry",
"selected": true,
"source": "reviewed_command_registry",
"source_ref": "audit tail",
"value": "audit.tail"
}
],
"precedence": "command_registry",
"resolution": "registry_identity",
"source": "reviewed_command_registry",
"source_ref": "audit tail",
"value": "audit.tail"
},
"confirmation": {
"candidates": [
{
"precedence": "reviewed_explicit",
"review_reason": "Local audit log tail from #555; no remote RPC.",
"selected": true,
"source": "internal/cli/schema_hints/metadata/audit.json",
"value": "not_required"
}
],
"precedence": "reviewed_explicit",
"resolution": "highest_precedence",
"review_reason": "Local audit log tail from #555; no remote RPC.",
"source": "internal/cli/schema_hints/metadata/audit.json",
"value": "not_required"
},
"description": {
"candidates": [
{
"precedence": "cobra_help",
"selected": true,
"source": "cobra_help",
"value": "查看最近的审计记录"
}
],
"precedence": "cobra_help",
"resolution": "highest_precedence",
"source": "cobra_help",
"value": "查看最近的审计记录"
},
"effect": {
"candidates": [
{
"precedence": "reviewed_explicit",
"review_reason": "Local audit log tail from #555; no remote RPC.",
"selected": true,
"source": "internal/cli/schema_hints/metadata/audit.json",
"value": "read"
}
],
"precedence": "reviewed_explicit",
"resolution": "highest_precedence",
"review_reason": "Local audit log tail from #555; no remote RPC.",
"source": "internal/cli/schema_hints/metadata/audit.json",
"value": "read"
},
"examples": {
"candidates": [
{
"precedence": "reviewed_explicit",
"review_reason": "纳入 #555 公开 audit leaf 的 Agent 选型文案;本地只读查看,示例不含 --yes。",
"selected": true,
"source": "internal/cli/schema_hints/selection/audit.json",
"value": [
"dws audit tail",
"dws audit tail --lines 50"
]
}
],
"precedence": "reviewed_explicit",
"resolution": "highest_precedence",
"review_reason": "纳入 #555 公开 audit leaf 的 Agent 选型文案;本地只读查看,示例不含 --yes。",
"source": "internal/cli/schema_hints/selection/audit.json",
"value": [
"dws audit tail",
"dws audit tail --lines 50"
]
},
"idempotency": {
"candidates": [
{
"precedence": "reviewed_explicit",
"review_reason": "Local audit log tail from #555; no remote RPC.",
"selected": true,
"source": "internal/cli/schema_hints/metadata/audit.json",
"value": "idempotent"
}
],
"precedence": "reviewed_explicit",
"resolution": "highest_precedence",
"review_reason": "Local audit log tail from #555; no remote RPC.",
"source": "internal/cli/schema_hints/metadata/audit.json",
"value": "idempotent"
},
"interface_mode": {
"candidates": [
{
"precedence": "reviewed_explicit",
"review_reason": "Local audit log tail from #555; no remote RPC.",
"selected": true,
"source": "internal/cli/schema_hints/metadata/audit.json",
"value": "local"
}
],
"precedence": "reviewed_explicit",
"resolution": "highest_precedence",
"review_reason": "Local audit log tail from #555; no remote RPC.",
"source": "internal/cli/schema_hints/metadata/audit.json",
"value": "local"
},
"interface_reason": {
"candidates": [
{
"precedence": "reviewed_explicit",
"review_reason": "Local audit log tail from #555; no remote RPC.",
"selected": true,
"source": "internal/cli/schema_hints/metadata/audit.json",
"value": "命令读取本地审计日志尾部,不绑定 pinned MCP RPC"
}
],
"precedence": "reviewed_explicit",
"resolution": "highest_precedence",
"review_reason": "Local audit log tail from #555; no remote RPC.",
"source": "internal/cli/schema_hints/metadata/audit.json",
"value": "命令读取本地审计日志尾部,不绑定 pinned MCP RPC"
},
"interface_ref": {
"candidates": [
{
"precedence": "reviewed_explicit",
"review_reason": "final interface mode local forbids a direct MCP interface_ref",
"selected": true,
"source": "internal/cli/schema_hints/metadata/audit.json",
"value": null
}
],
"precedence": "reviewed_explicit",
"resolution": "interface_disposition_matrix",
"review_reason": "final interface mode local forbids a direct MCP interface_ref",
"source": "internal/cli/schema_hints/metadata/audit.json",
"value": null
},
"reviewed": {
"candidates": [
{
"precedence": "reviewed_explicit",
"review_reason": "Local audit log tail from #555; no remote RPC.",
"selected": true,
"source": "internal/cli/schema_hints/metadata/audit.json",
"value": true
},
{
"precedence": "reviewed_explicit",
"review_reason": "纳入 #555 公开 audit leaf 的 Agent 选型文案;本地只读查看,示例不含 --yes。",
"selected": false,
"source": "internal/cli/schema_hints/selection/audit.json",
"value": true
}
],
"precedence": "reviewed_explicit",
"resolution": "highest_precedence",
"review_reason": "Local audit log tail from #555; no remote RPC.",
"source": "internal/cli/schema_hints/metadata/audit.json",
"value": true
},
"risk": {
"candidates": [
{
"precedence": "reviewed_explicit",
"review_reason": "Local audit log tail from #555; no remote RPC.",
"selected": true,
"source": "internal/cli/schema_hints/metadata/audit.json",
"value": "low"
}
],
"precedence": "reviewed_explicit",
"resolution": "highest_precedence",
"review_reason": "Local audit log tail from #555; no remote RPC.",
"source": "internal/cli/schema_hints/metadata/audit.json",
"value": "low"
},
"title": {
"candidates": [
{
"precedence": "cobra_help",
"selected": true,
"source": "cobra_help",
"value": "查看最近的审计记录"
}
],
"precedence": "cobra_help",
"resolution": "highest_precedence",
"source": "cobra_help",
"value": "查看最近的审计记录"
},
"use_when": {
"candidates": [
{
"precedence": "reviewed_explicit",
"review_reason": "纳入 #555 公开 audit leaf 的 Agent 选型文案;本地只读查看,示例不含 --yes。",
"selected": true,
"source": "internal/cli/schema_hints/selection/audit.json",
"value": [
"需要快速查看最近写入的审计记录(默认最近 20 条)"
]
}
],
"precedence": "reviewed_explicit",
"resolution": "highest_precedence",
"review_reason": "纳入 #555 公开 audit leaf 的 Agent 选型文案;本地只读查看,示例不含 --yes。",
"source": "internal/cli/schema_hints/selection/audit.json",
"value": [
"需要快速查看最近写入的审计记录(默认最近 20 条)"
]
}
},
"has_parameters": true,
"idempotency": "idempotent",
"interface_mode": "local",
"interface_reason": "命令读取本地审计日志尾部,不绑定 pinned MCP RPC",
"is_alias": false,
"name": "tail",
"parameter_count": 1,
"parameters": {
"lines": {
"default": "20",
"description": "显示最近 N 条记录",
"field_provenance": {
"description": {
"candidates": [
{
"precedence": "cobra_contract",
"selected": true,
"source": "cobra_usage",
"value": "显示最近 N 条记录"
},
{
"precedence": "default",
"selected": false,
"source": "default",
"value": ""
}
],
"precedence": "cobra_contract",
"resolution": "highest_precedence",
"source": "cobra_usage",
"value": "显示最近 N 条记录"
},
"property": {
"candidates": [
{
"precedence": "inference",
"selected": true,
"source": "flag_name_inference",
"value": "lines"
}
],
"precedence": "inference",
"resolution": "highest_precedence",
"source": "flag_name_inference",
"value": "lines"
},
"required": {
"candidates": [
{
"precedence": "cobra_contract",
"selected": true,
"source": "cobra_nonzero_default",
"value": false
},
{
"precedence": "default",
"selected": false,
"source": "default",
"value": false
}
],
"precedence": "cobra_contract",
"resolution": "highest_precedence",
"source": "cobra_nonzero_default",
"value": false
},
"required_when": {
"candidates": [
{
"precedence": "default",
"selected": true,
"source": "default",
"value": ""
}
],
"precedence": "default",
"resolution": "highest_precedence",
"source": "default",
"value": ""
},
"type": {
"candidates": [
{
"precedence": "cobra_contract",
"selected": true,
"source": "cobra_flag_type",
"value": "integer"
}
],
"precedence": "cobra_contract",
"resolution": "highest_precedence",
"source": "cobra_flag_type",
"value": "integer"
}
},
"property": "lines",
"required": false,
"type": "integer"
}
},
"path": "audit.tail",
"primary_cli_path": "audit tail",
"product_id": "audit",
"reviewed": true,
"risk": "low",
"source": "reviewed_command_registry",
"title": "查看最近的审计记录",
"use_when": [
"需要快速查看最近写入的审计记录(默认最近 20 条)"
]
},
"audit.verify": {
"agent_metadata_source": "embedded-skill-metadata",
"agent_source_refs": [
"cobra-help:dws audit verify --help",
"internal/app/audit_command.go",
"internal/cli/schema_command_registry.json#audit.verify",
"internal/cli/schema_hints/metadata/audit.json",
"internal/cli/schema_hints/selection/audit.json"
],
"agent_summary": "校验本地审计日志文件的哈希链完整性",
"agent_summary_source": "dws-agent-selection/audit",
"availability": "available",
"avoid_when": [
"只浏览或导出日志内容时用 audit tail / audit export"
],
"canonical_path": "audit.verify",
"cli_name": "verify",
"cli_path": "audit verify",
"confirmation": "not_required",
"description": "校验审计日志哈希链完整性",
"display": "操作审计日志管理",
"effect": "read",
"effect_source": "agent-hint",
"examples": [
"dws audit verify",
"dws audit verify --file /path/to/audit.jsonl"
],
"field_provenance": {
"agent_summary": {
"candidates": [
{
"precedence": "reviewed_explicit",
"review_reason": "纳入 #555 公开 audit leaf 的 Agent 选型文案;本地只读校验,示例不含 --yes。",
"selected": true,
"source": "internal/cli/schema_hints/selection/audit.json",
"value": "校验本地审计日志文件的哈希链完整性"
}
],
"precedence": "reviewed_explicit",
"resolution": "highest_precedence",
"review_reason": "纳入 #555 公开 audit leaf 的 Agent 选型文案;本地只读校验,示例不含 --yes。",
"source": "internal/cli/schema_hints/selection/audit.json",
"value": "校验本地审计日志文件的哈希链完整性"
},
"availability": {
"candidates": [
{
"precedence": "reviewed_explicit",
"review_reason": "Local audit hash-chain verify from #555; no remote RPC.",
"selected": true,
"source": "internal/cli/schema_hints/metadata/audit.json",
"value": "available"
}
],
"precedence": "reviewed_explicit",
"resolution": "highest_precedence",
"review_reason": "Local audit hash-chain verify from #555; no remote RPC.",
"source": "internal/cli/schema_hints/metadata/audit.json",
"value": "available"
},
"avoid_when": {
"candidates": [
{
"precedence": "reviewed_explicit",
"review_reason": "纳入 #555 公开 audit leaf 的 Agent 选型文案;本地只读校验,示例不含 --yes。",
"selected": true,
"source": "internal/cli/schema_hints/selection/audit.json",
"value": [
"只浏览或导出日志内容时用 audit tail / audit export"
]
}
],
"precedence": "reviewed_explicit",
"resolution": "highest_precedence",
"review_reason": "纳入 #555 公开 audit leaf 的 Agent 选型文案;本地只读校验,示例不含 --yes。",
"source": "internal/cli/schema_hints/selection/audit.json",
"value": [
"只浏览或导出日志内容时用 audit tail / audit export"
]
},
"canonical_path": {
"candidates": [
{
"precedence": "command_registry",
"selected": true,
"source": "reviewed_command_registry",
"source_ref": "audit verify",
"value": "audit.verify"
}
],
"precedence": "command_registry",
"resolution": "registry_identity",
"source": "reviewed_command_registry",
"source_ref": "audit verify",
"value": "audit.verify"
},
"confirmation": {
"candidates": [
{
"precedence": "reviewed_explicit",
"review_reason": "Local audit hash-chain verify from #555; no remote RPC.",
"selected": true,
"source": "internal/cli/schema_hints/metadata/audit.json",
"value": "not_required"
}
],
"precedence": "reviewed_explicit",
"resolution": "highest_precedence",
"review_reason": "Local audit hash-chain verify from #555; no remote RPC.",
"source": "internal/cli/schema_hints/metadata/audit.json",
"value": "not_required"
},
"description": {
"candidates": [
{
"precedence": "cobra_help",
"selected": true,
"source": "cobra_help",
"value": "校验审计日志哈希链完整性"
}
],
"precedence": "cobra_help",
"resolution": "highest_precedence",
"source": "cobra_help",
"value": "校验审计日志哈希链完整性"
},
"effect": {
"candidates": [
{
"precedence": "reviewed_explicit",
"review_reason": "Local audit hash-chain verify from #555; no remote RPC.",
"selected": true,
"source": "internal/cli/schema_hints/metadata/audit.json",
"value": "read"
}
],
"precedence": "reviewed_explicit",
"resolution": "highest_precedence",
"review_reason": "Local audit hash-chain verify from #555; no remote RPC.",
"source": "internal/cli/schema_hints/metadata/audit.json",
"value": "read"
},
"examples": {
"candidates": [
{
"precedence": "reviewed_explicit",
"review_reason": "纳入 #555 公开 audit leaf 的 Agent 选型文案;本地只读校验,示例不含 --yes。",
"selected": true,
"source": "internal/cli/schema_hints/selection/audit.json",
"value": [
"dws audit verify",
"dws audit verify --file /path/to/audit.jsonl"
]
}
],
"precedence": "reviewed_explicit",
"resolution": "highest_precedence",
"review_reason": "纳入 #555 公开 audit leaf 的 Agent 选型文案;本地只读校验,示例不含 --yes。",
"source": "internal/cli/schema_hints/selection/audit.json",
"value": [
"dws audit verify",
"dws audit verify --file /path/to/audit.jsonl"
]
},
"idempotency": {
"candidates": [
{
"precedence": "reviewed_explicit",
"review_reason": "Local audit hash-chain verify from #555; no remote RPC.",
"selected": true,
"source": "internal/cli/schema_hints/metadata/audit.json",
"value": "idempotent"
}
],
"precedence": "reviewed_explicit",
"resolution": "highest_precedence",
"review_reason": "Local audit hash-chain verify from #555; no remote RPC.",
"source": "internal/cli/schema_hints/metadata/audit.json",
"value": "idempotent"
},
"interface_mode": {
"candidates": [
{
"precedence": "reviewed_explicit",
"review_reason": "Local audit hash-chain verify from #555; no remote RPC.",
"selected": true,
"source": "internal/cli/schema_hints/metadata/audit.json",
"value": "local"
}
],
"precedence": "reviewed_explicit",
"resolution": "highest_precedence",
"review_reason": "Local audit hash-chain verify from #555; no remote RPC.",
"source": "internal/cli/schema_hints/metadata/audit.json",
"value": "local"
},
"interface_reason": {
"candidates": [
{
"precedence": "reviewed_explicit",
"review_reason": "Local audit hash-chain verify from #555; no remote RPC.",
"selected": true,
"source": "internal/cli/schema_hints/metadata/audit.json",
"value": "命令校验本地审计日志哈希链,不绑定 pinned MCP RPC"
}
],
"precedence": "reviewed_explicit",
"resolution": "highest_precedence",
"review_reason": "Local audit hash-chain verify from #555; no remote RPC.",
"source": "internal/cli/schema_hints/metadata/audit.json",
"value": "命令校验本地审计日志哈希链,不绑定 pinned MCP RPC"
},
"interface_ref": {
"candidates": [
{
"precedence": "reviewed_explicit",
"review_reason": "final interface mode local forbids a direct MCP interface_ref",
"selected": true,
"source": "internal/cli/schema_hints/metadata/audit.json",
"value": null
}
],
"precedence": "reviewed_explicit",
"resolution": "interface_disposition_matrix",
"review_reason": "final interface mode local forbids a direct MCP interface_ref",
"source": "internal/cli/schema_hints/metadata/audit.json",
"value": null
},
"reviewed": {
"candidates": [
{
"precedence": "reviewed_explicit",
"review_reason": "Local audit hash-chain verify from #555; no remote RPC.",
"selected": true,
"source": "internal/cli/schema_hints/metadata/audit.json",
"value": true
},
{
"precedence": "reviewed_explicit",
"review_reason": "纳入 #555 公开 audit leaf 的 Agent 选型文案;本地只读校验,示例不含 --yes。",
"selected": false,
"source": "internal/cli/schema_hints/selection/audit.json",
"value": true
}
],
"precedence": "reviewed_explicit",
"resolution": "highest_precedence",
"review_reason": "Local audit hash-chain verify from #555; no remote RPC.",
"source": "internal/cli/schema_hints/metadata/audit.json",
"value": true
},
"risk": {
"candidates": [
{
"precedence": "reviewed_explicit",
"review_reason": "Local audit hash-chain verify from #555; no remote RPC.",
"selected": true,
"source": "internal/cli/schema_hints/metadata/audit.json",
"value": "low"
}
],
"precedence": "reviewed_explicit",
"resolution": "highest_precedence",
"review_reason": "Local audit hash-chain verify from #555; no remote RPC.",
"source": "internal/cli/schema_hints/metadata/audit.json",
"value": "low"
},
"title": {
"candidates": [
{
"precedence": "cobra_help",
"selected": true,
"source": "cobra_help",
"value": "校验审计日志哈希链完整性"
}
],
"precedence": "cobra_help",
"resolution": "highest_precedence",
"source": "cobra_help",
"value": "校验审计日志哈希链完整性"
},
"use_when": {
"candidates": [
{
"precedence": "reviewed_explicit",
"review_reason": "纳入 #555 公开 audit leaf 的 Agent 选型文案;本地只读校验,示例不含 --yes。",
"selected": true,
"source": "internal/cli/schema_hints/selection/audit.json",
"value": [
"怀疑审计文件被篡改,或需要确认最新/指定文件哈希链是否完整"
]
}
],
"precedence": "reviewed_explicit",
"resolution": "highest_precedence",
"review_reason": "纳入 #555 公开 audit leaf 的 Agent 选型文案;本地只读校验,示例不含 --yes。",
"source": "internal/cli/schema_hints/selection/audit.json",
"value": [
"怀疑审计文件被篡改,或需要确认最新/指定文件哈希链是否完整"
]
}
},
"has_parameters": true,
"idempotency": "idempotent",
"interface_mode": "local",
"interface_reason": "命令校验本地审计日志哈希链,不绑定 pinned MCP RPC",
"is_alias": false,
"name": "verify",
"parameter_count": 1,
"parameters": {
"file": {
"description": "指定审计文件路径(默认最新文件)",
"field_provenance": {
"description": {
"candidates": [
{
"precedence": "cobra_contract",
"selected": true,
"source": "cobra_usage",
"value": "指定审计文件路径(默认最新文件)"
},
{
"precedence": "default",
"selected": false,
"source": "default",
"value": ""
}
],
"precedence": "cobra_contract",
"resolution": "highest_precedence",
"source": "cobra_usage",
"value": "指定审计文件路径(默认最新文件)"
},
"property": {
"candidates": [
{
"precedence": "inference",
"selected": true,
"source": "flag_name_inference",
"value": "file"
}
],
"precedence": "inference",
"resolution": "highest_precedence",
"source": "flag_name_inference",
"value": "file"
},
"required": {
"candidates": [
{
"precedence": "cobra_contract",
"selected": true,
"source": "cobra_nonzero_default",
"value": false
},
{
"precedence": "default",
"selected": false,
"source": "default",
"value": false
}
],
"precedence": "cobra_contract",
"resolution": "highest_precedence",
"source": "cobra_nonzero_default",
"value": false
},
"required_when": {
"candidates": [
{
"precedence": "default",
"selected": true,
"source": "default",
"value": ""
}
],
"precedence": "default",
"resolution": "highest_precedence",
"source": "default",
"value": ""
},
"type": {
"candidates": [
{
"precedence": "cobra_contract",
"selected": true,
"source": "cobra_flag_type",
"value": "string"
}
],
"precedence": "cobra_contract",
"resolution": "highest_precedence",
"source": "cobra_flag_type",
"value": "string"
}
},
"property": "file",
"required": false,
"type": "string"
}
},
"path": "audit.verify",
"primary_cli_path": "audit verify",
"product_id": "audit",
"reviewed": true,
"risk": "low",
"source": "reviewed_command_registry",
"title": "校验审计日志哈希链完整性",
"use_when": [
"怀疑审计文件被篡改,或需要确认最新/指定文件哈希链是否完整"
]
}
}
}