Files
dingtalk-workspace-cli/internal/cli/runtime_schema_seam.go
T
玉澜 ea43db1d64 refactor(schema): drop cli shim packages, add testseam swap, consolidate ForTest helpers
- import 统一:删除 cli/contractfinal 与 cli/runtimeannotate 垫片包,
  26 个消费文件一律直引 corecmd/*;cli 根仅保留 runtime_schema_seam.go
  包内别名,依赖图保持单向无环
- 新增 internal/testseam.Swap[T]:包级 var 注入缝置换由 t.Cleanup
  结构性恢复;迁移 pipeline*/stdinIsTerminalFn/loadReviewedCommandRegistry/
  schemaCommandCatalogError/schemaParameterBindingData/finalSchemaAgentMetadata
  六组核心缝(26+ 处)
- ForTest 辅助归拢到 per-package fortest.go(corecmd/contract、
  corecmd/contractfinal、shortcut、cli),生产文件只留真逻辑
- 文档同步:runtime_schema_seam.go / runtimeannotate/doc.go 注释、
  CHANGELOG、RFC §278-279、AGENTS.md
2026-08-03 00:50:16 +08:00

83 lines
4.3 KiB
Go

// Copyright 2026 Alibaba Group
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
package cli
import (
"github.com/spf13/cobra"
"github.com/spf13/pflag"
"github.com/DingTalk-Real-AI/dingtalk-workspace-cli/internal/corecmd/contract"
"github.com/DingTalk-Real-AI/dingtalk-workspace-cli/internal/corecmd/contractfinal"
"github.com/DingTalk-Real-AI/dingtalk-workspace-cli/internal/corecmd/runtimeannotate"
)
// The declaration model and its runtime stores live under internal/corecmd/*
// and every package imports them directly from there. This file only keeps
// the cli.* convenience aliases so the delivery root's own code reads flat;
// no separate cli shim packages exist.
type RuntimeSchemaConstraints = runtimeannotate.RuntimeSchemaConstraints
var (
AttachRuntimeSchema = runtimeannotate.AttachRuntimeSchema
AnnotateRuntimeToolMetadata = runtimeannotate.AnnotateRuntimeToolMetadata
AnnotateRuntimeFlag = runtimeannotate.AnnotateRuntimeFlag
AnnotateRuntimeFlagProperty = runtimeannotate.AnnotateRuntimeFlagProperty
AnnotateRuntimeRequiredFlags = runtimeannotate.AnnotateRuntimeRequiredFlags
AnnotateRuntimeFlagRequiredValue = runtimeannotate.AnnotateRuntimeFlagRequiredValue
AnnotateRuntimeFlagDescription = runtimeannotate.AnnotateRuntimeFlagDescription
AnnotateRuntimeFlagRequiredWhen = runtimeannotate.AnnotateRuntimeFlagRequiredWhen
AnnotateRuntimeFlagFormat = runtimeannotate.AnnotateRuntimeFlagFormat
AnnotateRuntimeFlagInterfaceType = runtimeannotate.AnnotateRuntimeFlagInterfaceType
AnnotateRuntimeFlagEnum = runtimeannotate.AnnotateRuntimeFlagEnum
AnnotateRuntimeFlagExample = runtimeannotate.AnnotateRuntimeFlagExample
AnnotateRuntimeContract = runtimeannotate.AnnotateRuntimeContract
AnnotateRuntimeRisk = runtimeannotate.AnnotateRuntimeRisk
AnnotateRuntimeGate = runtimeannotate.AnnotateRuntimeGate
RuntimeContractRisk = runtimeannotate.RuntimeContractRisk
RuntimeContractGate = runtimeannotate.RuntimeContractGate
AnnotateRuntimeConstraints = runtimeannotate.AnnotateRuntimeConstraints
AnnotateRuntimePositionals = runtimeannotate.AnnotateRuntimePositionals
ExcludeFromRuntimeSchema = runtimeannotate.ExcludeFromRuntimeSchema
HasDeclaredOrAnnotatedConfirmation = contractfinal.HasDeclaredOrAnnotatedConfirmation
RuntimeContractFinal = contractfinal.RuntimeContractFinal
HasRuntimeContractFinal = contractfinal.HasRuntimeContractFinal
ClearRuntimeContractFinalForTest = contractfinal.ClearRuntimeContractFinalForTest
StoreRuntimeContractFinalRawForTest = contractfinal.StoreRuntimeContractFinalRawForTest
ApplyParamDecls = contractfinal.ApplyParamDecls
)
// RegisterRuntimeContractFinal is the sole production registration entry for
// product / helper / shortcut code (annotate + store). Framework code calls
// corecmd/contractfinal.RegisterRuntimeContractFinal directly.
func RegisterRuntimeContractFinal(cmd *cobra.Command, payload contract.ContractFinalPayload) {
contractfinal.RegisterRuntimeContractFinal(cmd, payload)
}
func resolvedFieldProvenance(value any, source, sourceRef, precedence, resolution, reviewReason string) contract.FieldProvenance {
return contract.ResolvedFieldProvenance(value, source, sourceRef, precedence, resolution, reviewReason)
}
func setRuntimeCommandAnnotation(cmd *cobra.Command, key, value string) {
runtimeannotate.SetCommandAnnotation(cmd, key, value)
}
func setFlagAnnotation(flag *pflag.Flag, key, value string) {
runtimeannotate.SetFlagAnnotation(flag, key, value)
}
func setFlagAnnotationValues(flag *pflag.Flag, key string, values ...string) {
runtimeannotate.SetFlagAnnotationValues(flag, key, values...)
}