feat(urgency): 通用紧急度通道(Declarer/Level + 只抬不压折算)+ IoT 首个生产者 + 她自己的结论走结构化标记穿透安静时段
CI / Backend (build / vet / test / cross-compile) (push) Has been cancelled
CI / Frontend (tsc + vite build) (push) Has been cancelled

This commit is contained in:
AskaEth committed 2026-10-05 13:11:04 +08:00
1 parent 4a2d276881
commit f91a83ff81
14 files changed
+917 -15

No files matched your search

+61
View File
@@ -0,0 +1,61 @@
// Package urgency 定义 Cyrene 全局通用的「事件紧急度」词汇,以及事件生产者声明它
// 的契约。
//
// 它是一条**通用通道**:任何事件生产者 —— IoT(第一个使用者,规则表见
// internal/iot/safety.go)、其它外围插件、系统 / 能力模块 —— 都可以在发布到进程内
// bus 的载荷上实现 Declarer,声明「这次事件有多紧急」。backthink 在唯一一处
// (trigger.go 的 triggerForEvent)把该声明与既有的 SystemEvent.Import 口径一起折算
// 进 Trigger.Import,因此安全域(critical)事件能穿透安静时段与工作 / 忙碌
// (design/12 §2 §6 安全域豁免,裁决 1.8 / 07.4.2),而 backthink 绝不需要认识任何
// 生产者(IoT 或插件)的专有字段。
//
// 本包刻意是叶子包(只依赖 fmt):生产者不必为了声明紧急度而依赖 backthink
// (backthink 依赖 iot,那样会成环),backthink 也不必为每个生产者各加一条分支。
package urgency
import "fmt"
// Level 是一次事件的显式紧急度,由产生该事件的生产者 *显式* 声明。零值是
// LevelRoutine,因此未声明紧急度的事件一律落在例行档:本通道不会让常规事件获得
// 穿透安静时段的资格(默认保守,design/12 §6 安全域豁免的反面保证)。
//
// 它只回答「这次事件有多紧急」,不表达身份、权限或能力边界 —— 身份与权限永远由
// channel 层的 actor 元数据与策略引擎决定。
type Level int
const (
// LevelRoutine 是例行变化(普通设备状态跃迁、低价值系统噪声)。它折算为
// backthink 的 ImportanceNormal:安静时段照常扣下。
LevelRoutine Level = iota
// LevelWarning 是值得注意但非安全域的异常(设备离线、耗材将尽)。它折算为
// ImportanceHigh:沿袭既有级联语义通过安静时段,但不穿透工作 / 忙碌。
LevelWarning
// LevelCritical 是安全域事件(入侵、门锁异常开启、烟雾 / 漏水告警)。
// 它折算为 ImportanceCritical:穿透安静时段与工作 / 忙碌。
LevelCritical
)
// String 返回用于日志与记录(审计轨迹、思考记录、前端小字)的稳定标签。
func (l Level) String() string {
switch l {
case LevelRoutine:
return "routine"
case LevelWarning:
return "warning"
case LevelCritical:
return "critical"
default:
return fmt.Sprintf("urgency(%d)", int(l))
}
}
// Declarer 是「事件载荷自带紧急度」的通用契约。事件载荷实现它,backthink 就会在
// 通用通道上承认其声明的紧急度,无需为该生产者另加分支 —— 生产者有多少个都不影响
// 判定侧的形状。
//
// 实现方应当保持保守:只有语义上确属安全域的事件才返回 LevelCritical,其余一律
// 落在零值 LevelRoutine(那样安静时段照常扣下)。
type Declarer interface {
// Urgency 返回这次事件的紧急度;未声明时返回零值 LevelRoutine。
Urgency() Level
}
+41
View File
@@ -0,0 +1,41 @@
package urgency
import "testing"
// zeroDeclarer 是一个未声明紧急度的生产者替身:它只实现契约本身。
type zeroDeclarer struct{}
func (zeroDeclarer) Urgency() Level { return LevelRoutine }
// TestLevel_ZeroValueIsRoutine 钉住本通道的默认保守:未声明(零值)与显式声明
// routine 同义,因此既有的、没标紧急度的事件生产者行为逐字不变。
func TestLevel_ZeroValueIsRoutine(t *testing.T) {
t.Parallel()
var l Level
if l != LevelRoutine {
t.Fatalf("zero Level = %v, want %v", l, LevelRoutine)
}
var d Declarer = zeroDeclarer{}
if got := d.Urgency(); got != LevelRoutine {
t.Fatalf("undeclared urgency = %v, want %v", got, LevelRoutine)
}
}
// TestLevel_String 钉住标签稳定(日志、审计与思考记录依赖它)。
func TestLevel_String(t *testing.T) {
t.Parallel()
cases := []struct {
in Level
want string
}{
{in: LevelRoutine, want: "routine"},
{in: LevelWarning, want: "warning"},
{in: LevelCritical, want: "critical"},
{in: Level(7), want: "urgency(7)"},
}
for _, tc := range cases {
if got := tc.in.String(); got != tc.want {
t.Fatalf("Level(%d).String() = %q, want %q", int(tc.in), got, tc.want)
}
}
}