From dbeed2f1b67eb417ce089e7033a228578fbbeb03 Mon Sep 17 00:00:00 2001
From: weichen <weichen@local>
Date: Tue, 29 Sep 2026 15:56:51 +0000
Subject: [PATCH] Add squad.intent_refused for the Agent-Squad intent gate.

---
 docs/agent-squad-mapping.md | 1 +
 domains/squad.go            | 2 ++
 domains/squad.json          | 9 +++++++++
 errcode/codes.go            | 1 +
 4 files changed, 13 insertions(+)

diff --git a/docs/agent-squad-mapping.md b/docs/agent-squad-mapping.md
index 5738b47..8b3e459 100644
--- a/docs/agent-squad-mapping.md
+++ b/docs/agent-squad-mapping.md
@@ -14,6 +14,7 @@
 | 步骤 `EvStepFailed` | squad.step_failed | 500 | 瞬时失败仍受步骤重试上限约束 |
 | 质检失败且自动修复预算用尽 | squad.quality_failed | 422 | 可转 quality_review 人工放行 |
 | `context cancelled` | squad.cancelled | 499 | 步骤保持 pending，可恢复 |
+| 意图闸门守卫命中（`squadintent` 适配器，运行入口拒绝） | squad.intent_refused | 400 | 守卫"识别即拒绝"；按引导改写目标，不重试原文本 |
 | JSON 解码失败 | sys.invalid_argument | 400 | 框架域，不单开小队码 |
 | 未分类的 500 | sys.internal | 500 | 必须带 trace_id |
 
diff --git a/domains/squad.go b/domains/squad.go
index f8b9a53..6e3b326 100644
--- a/domains/squad.go
+++ b/domains/squad.go
@@ -23,4 +23,6 @@ func registerSquad(r *errcode.Registry) {
 		"交付质检未通过", "修复交付物或走人工放行；自动修复预算用尽后不要假装完成"))
 	must(r, def(errcode.SquadCancelled, 499, errcode.SeverityInfo, errcode.RetryNever, errcode.SideEffectPossible,
 		"运行已取消", "取消后的步骤保持可恢复，不要写成成功"))
+	must(r, def(errcode.SquadIntentRefused, 400, errcode.SeverityWarn, errcode.RetryNever, errcode.SideEffectNone,
+		"目标被意图守卫拒绝", "该输入命中守卫意图；按引导调整目标，或改用对应系统功能入口，不要重试原文本"))
 }
diff --git a/domains/squad.json b/domains/squad.json
index 6b2c437..1ae17f2 100644
--- a/domains/squad.json
+++ b/domains/squad.json
@@ -35,6 +35,15 @@
     "summary": "运行挂起等待人工",
     "hint": "读取 pending 请求，回应后再续跑；不要并发重复推进"
   },
+  {
+    "code": "squad.intent_refused",
+    "http": 400,
+    "severity": "warn",
+    "retry": "never",
+    "side_effects": "none",
+    "summary": "目标被意图守卫拒绝",
+    "hint": "该输入命中守卫意图；按引导调整目标，或改用对应系统功能入口，不要重试原文本"
+  },
   {
     "code": "squad.plan_rejected",
     "http": 422,
diff --git a/errcode/codes.go b/errcode/codes.go
index 48498c3..9973b1c 100644
--- a/errcode/codes.go
+++ b/errcode/codes.go
@@ -47,6 +47,7 @@ const (
 	SquadStepFailed        Code = "squad.step_failed"
 	SquadQualityFailed     Code = "squad.quality_failed"
 	SquadCancelled         Code = "squad.cancelled"
+	SquadIntentRefused     Code = "squad.intent_refused"
 )
 
 // 意图识别域。对齐 agent-intent 核心包错误常量；消费方以 catalogcheck 对齐测试防止双权威。