abelien-harness 0.20.0 → 0.22.0

package/skills/abelien-workspace/assets/journey-stage-plan.json

@@ -1,6 +1,6 @@
 {
   "schema": "abelien.journey-stage-plan.v1",
-  "plan_version": "2026-10-20.1",
+  "plan_version": "2026-10-20.3",
   "description": "按意图的作品旅程阶段计划，是 A1 通过之后到交付首版这一段（及其旁路）的阶段顺序、阶段目标、领域规则与允许动作的唯一来源；本计划按意图编译成创作流程图（flows/creation.<intent>.json），Web、Claude Code、Codex 等所有宿主都从图上读取阶段顺序与每个阶段的目标、规则、允许动作和确认卡（Web 经 runtime 的 createFlowResolver），不另维护阶段顺序或工具白名单。orders 是自动推进的主线；side 阶段由宿主守卫按真实结果触发。每个阶段的 directives 是领域规则（宿主中立），宿主把它们附在自己的执行说明（工具名、字段）之后，不改写、不删减。每个阶段的 actions 是该阶段允许的动作，取自 action_catalog（宿主中立的动作 ID 清单；动作的说明、参数与错误码只在各域包的动作定义里，不在本计划重复），按意图不同时写在 action_variants；宿主把动作映射为自己的工具，自动阶段只放行这些工具和宿主自己的只读工具。references/journey-stage-plan.md（阶段计划一览）由 tools/render-journey-plan.mjs 从本计划生成；references/user-journey.md 维护 A1–C 判定与产品规则，本计划不得与之冲突。gate 是环节结束后由宿主固定发出的确认卡（问题、选项与各选项的动作，动作取自 gate_actions；answers 是非继续动作的领域规则），waits_for 是该阶段开始前必须已答的确认卡所属阶段（按意图不同时写在 waits_for_variants），卡片不等人，只有声明了 waits_for 的阶段才停下等答复。改动本计划须升 plan_version、在 test/creation-stage-views.test.mjs 的 HISTORY 追加一行，并重新生成一览与创作流程图。",
   "artifacts": [
     "reference_final",
@@ -10,7 +10,8 @@
     "appearance_baseline",
     "cad_candidate",
     "review",
-    "version_questions"
+    "version_questions",
+    "appearance_views"
   ],
   "orders": {
     "create": [
@@ -65,7 +66,9 @@
     "skeleton_revise",
     "fallback",
     "questions",
-    "questions_card"
+    "questions_card",
+    "appearance_views",
+    "views_fallback"
   ],
   "action_catalog": [
     "reference.research",
@@ -504,6 +507,28 @@
       "actions": [
         "question.card"
       ]
+    },
+    "appearance_views": {
+      "goal": "Generate internal spatial views of the confirmed concept",
+      "directives": [
+        "Use image.generate with spatial_views purpose. Choose complementary orientations to explain spatial and structural relationships. No additional user image or review gate."
+      ],
+      "actions": [
+        "image.generate"
+      ],
+      "waits_for": [
+        "concept"
+      ]
+    },
+    "views_fallback": {
+      "goal": "Use the confirmed original after definite views failure",
+      "directives": [
+        "Deterministic fallback; no model or provider request."
+      ],
+      "actions": [],
+      "waits_for": [
+        "concept"
+      ]
     }
   },
   "flow": {
@@ -541,6 +566,37 @@
             "module": "scripts/creation-tasks.mjs",
             "finalize": "referenceFinalize",
             "view": "briefImagesView"
+          },
+          "context_retention": {
+            "schema": "abelien.node-context-retention.v1",
+            "required": [
+              "schema",
+              "reply_to",
+              "flow",
+              "target_revision_ref",
+              "attempt",
+              "goal",
+              "instruction",
+              "refs",
+              "skills",
+              "actions",
+              "output",
+              "work",
+              "reply_without_model",
+              "correction",
+              "attempts",
+              "budget"
+            ],
+            "history": {
+              "reasoning": "summarize",
+              "assistant_text": "exact",
+              "tool_results": {
+                "default": "exact",
+                "by_action": {
+                  "reference.page": "reference"
+                }
+              }
+            }
           }
         },
         "produces_schema": "abelien.reference-evidence.v1"
@@ -597,6 +653,37 @@
             "module": "scripts/creation-tasks.mjs",
             "finalize": "referenceFinalize",
             "view": "briefImagesView"
+          },
+          "context_retention": {
+            "schema": "abelien.node-context-retention.v1",
+            "required": [
+              "schema",
+              "reply_to",
+              "flow",
+              "target_revision_ref",
+              "attempt",
+              "goal",
+              "instruction",
+              "refs",
+              "skills",
+              "actions",
+              "output",
+              "work",
+              "reply_without_model",
+              "correction",
+              "attempts",
+              "budget"
+            ],
+            "history": {
+              "reasoning": "summarize",
+              "assistant_text": "exact",
+              "tool_results": {
+                "default": "exact",
+                "by_action": {
+                  "reference.page": "reference"
+                }
+              }
+            }
           }
         },
         "produces_schema": "abelien.reference-evidence.v1"
@@ -631,6 +718,19 @@
             "module": "scripts/creation-tasks.mjs",
             "view": "conceptView",
             "finalize": "conceptFinalize"
+          },
+          "bound_params": {
+            "image.generate": {
+              "fixed_input": [
+                "schema",
+                "purpose",
+                "requirements_ref",
+                "source_images",
+                "confirmation_ref",
+                "output_role",
+                "view_specs"
+              ]
+            }
           }
         }
       },
@@ -667,7 +767,40 @@
           "restore": []
         },
         "produces": "hardware",
-        "produces_schema": "abelien.workspace.hardware-result.v1"
+        "produces_schema": "abelien.workspace.hardware-result.v1",
+        "task": {
+          "context_retention": {
+            "schema": "abelien.node-context-retention.v1",
+            "required": [
+              "schema",
+              "reply_to",
+              "flow",
+              "target_revision_ref",
+              "attempt",
+              "goal",
+              "instruction",
+              "refs",
+              "skills",
+              "actions",
+              "output",
+              "work",
+              "reply_without_model",
+              "correction",
+              "attempts",
+              "budget"
+            ],
+            "history": {
+              "reasoning": "summarize",
+              "assistant_text": "exact",
+              "tool_results": {
+                "default": "exact",
+                "by_action": {
+                  "hardware.wiki": "reference"
+                }
+              }
+            }
+          }
+        }
       },
       "points_read": {
         "rules": "points.read",
@@ -701,6 +834,36 @@
                 "ready"
               ]
             }
+          ],
+          "create": [
+            {
+              "artifact": "concept_image",
+              "accept_quality": [
+                "ready"
+              ]
+            },
+            {
+              "artifact": "appearance_views",
+              "accept_quality": [
+                "ready",
+                "degraded"
+              ]
+            }
+          ],
+          "modify": [
+            {
+              "artifact": "concept_image",
+              "accept_quality": [
+                "ready"
+              ]
+            },
+            {
+              "artifact": "appearance_views",
+              "accept_quality": [
+                "ready",
+                "degraded"
+              ]
+            }
           ]
         },
         "produces": "points_reading",
@@ -1078,6 +1241,62 @@
                 "ready"
               ]
             }
+          ],
+          "create": [
+            {
+              "artifact": "hardware",
+              "accept_quality": [
+                "ready"
+              ]
+            },
+            {
+              "artifact": "appearance_points",
+              "accept_quality": [
+                "ready",
+                "degraded"
+              ]
+            },
+            {
+              "artifact": "concept_image",
+              "accept_quality": [
+                "ready"
+              ]
+            },
+            {
+              "artifact": "appearance_views",
+              "accept_quality": [
+                "ready",
+                "degraded"
+              ]
+            }
+          ],
+          "modify": [
+            {
+              "artifact": "hardware",
+              "accept_quality": [
+                "ready"
+              ]
+            },
+            {
+              "artifact": "appearance_points",
+              "accept_quality": [
+                "ready",
+                "degraded"
+              ]
+            },
+            {
+              "artifact": "concept_image",
+              "accept_quality": [
+                "ready"
+              ]
+            },
+            {
+              "artifact": "appearance_views",
+              "accept_quality": [
+                "ready",
+                "degraded"
+              ]
+            }
           ]
         },
         "produces": "skeleton",
@@ -1171,6 +1390,39 @@
             "hardware": "{{needs.hardware.data}}",
             "failure": "{{failure}}"
           }
+        },
+        "task": {
+          "context_retention": {
+            "schema": "abelien.node-context-retention.v1",
+            "required": [
+              "schema",
+              "reply_to",
+              "flow",
+              "target_revision_ref",
+              "attempt",
+              "goal",
+              "instruction",
+              "refs",
+              "skills",
+              "actions",
+              "output",
+              "work",
+              "reply_without_model",
+              "correction",
+              "attempts",
+              "budget"
+            ],
+            "history": {
+              "reasoning": "summarize",
+              "assistant_text": "exact",
+              "tool_results": {
+                "default": "exact",
+                "by_action": {
+                  "hardware.wiki": "reference"
+                }
+              }
+            }
+          }
         }
       },
       "hardware_decision": {
@@ -1445,6 +1697,62 @@
                 "ready"
               ]
             }
+          ],
+          "create": [
+            {
+              "artifact": "concept_image",
+              "accept_quality": [
+                "ready"
+              ]
+            },
+            {
+              "artifact": "hardware",
+              "accept_quality": [
+                "ready"
+              ]
+            },
+            {
+              "artifact": "skeleton",
+              "accept_quality": [
+                "ready",
+                "degraded"
+              ]
+            },
+            {
+              "artifact": "appearance_views",
+              "accept_quality": [
+                "ready",
+                "degraded"
+              ]
+            }
+          ],
+          "modify": [
+            {
+              "artifact": "concept_image",
+              "accept_quality": [
+                "ready"
+              ]
+            },
+            {
+              "artifact": "hardware",
+              "accept_quality": [
+                "ready"
+              ]
+            },
+            {
+              "artifact": "skeleton",
+              "accept_quality": [
+                "ready",
+                "degraded"
+              ]
+            },
+            {
+              "artifact": "appearance_views",
+              "accept_quality": [
+                "ready",
+                "degraded"
+              ]
+            }
           ]
         },
         "produces": "appearance_baseline",
@@ -1640,6 +1948,76 @@
                 "degraded"
               ]
             }
+          ],
+          "create": [
+            {
+              "artifact": "hardware",
+              "accept_quality": [
+                "ready"
+              ]
+            },
+            {
+              "artifact": "appearance_points",
+              "accept_quality": [
+                "ready",
+                "degraded"
+              ]
+            },
+            {
+              "artifact": "concept_image",
+              "accept_quality": [
+                "ready"
+              ]
+            },
+            {
+              "artifact": "skeleton",
+              "accept_quality": [
+                "ready",
+                "degraded"
+              ]
+            },
+            {
+              "artifact": "appearance_views",
+              "accept_quality": [
+                "ready",
+                "degraded"
+              ]
+            }
+          ],
+          "modify": [
+            {
+              "artifact": "hardware",
+              "accept_quality": [
+                "ready"
+              ]
+            },
+            {
+              "artifact": "appearance_points",
+              "accept_quality": [
+                "ready",
+                "degraded"
+              ]
+            },
+            {
+              "artifact": "concept_image",
+              "accept_quality": [
+                "ready"
+              ]
+            },
+            {
+              "artifact": "skeleton",
+              "accept_quality": [
+                "ready",
+                "degraded"
+              ]
+            },
+            {
+              "artifact": "appearance_views",
+              "accept_quality": [
+                "ready",
+                "degraded"
+              ]
+            }
           ]
         },
         "produces": "skeleton",
@@ -1873,6 +2251,89 @@
             "questions": "{{needs.version_questions.data.questions}}"
           }
         }
+      },
+      "appearance_views": {
+        "target": [
+          "requirements"
+        ],
+        "intents": [
+          "create",
+          "modify"
+        ],
+        "needs": [
+          {
+            "artifact": "concept_image",
+            "accept_quality": [
+              "ready"
+            ]
+          }
+        ],
+        "produces": "appearance_views",
+        "produces_schema": "appearance.views.v1",
+        "task": {
+          "output": {
+            "package": "abelien-workspace",
+            "schema": "schemas/appearance-views.v1.json",
+            "reply": {
+              "package": "abelien-workspace",
+              "schema": "schemas/host-ack-reply.v1.json"
+            }
+          },
+          "builder": {
+            "package": "abelien-workspace",
+            "module": "scripts/appearance-views.mjs",
+            "view": "spatialViewsView",
+            "finalize": "spatialViewsFinalize"
+          },
+          "bound_params": {
+            "image.generate": {
+              "fixed_input": [
+                "schema",
+                "purpose",
+                "requirements_ref",
+                "source_images",
+                "confirmation_ref",
+                "output_role"
+              ]
+            }
+          },
+          "budget": {
+            "attempts": 3
+          }
+        }
+      },
+      "views_fallback": {
+        "target": [
+          "requirements"
+        ],
+        "intents": [
+          "create",
+          "modify"
+        ],
+        "needs": [
+          {
+            "artifact": "concept_image",
+            "accept_quality": [
+              "ready"
+            ]
+          }
+        ],
+        "fallback_for": "appearance_views",
+        "quality": "degraded",
+        "produces": "appearance_views",
+        "produces_schema": "appearance.views.v1",
+        "task": {
+          "output": {
+            "package": "abelien-workspace",
+            "schema": "schemas/appearance-views.v1.json"
+          },
+          "builder": {
+            "package": "abelien-workspace",
+            "module": "scripts/appearance-views.mjs",
+            "view": "spatialViewsFallbackView",
+            "finalize": "spatialViewsFallbackFinalize"
+          }
+        }
       }
     }
   }

package/skills/abelien-workspace/assets/lane-plan.json

@@ -51,8 +51,8 @@
           "directives": [
             "按 abelien-appearance/references/points.md 第一步读图（还原读识别出的产品图，其余读当前概念图）：只报看得见的面，每个特征一个点位，读图输出不填槽位。",
             "提交时与槽位无关的校验（摘要、可见面、坐标范围、reaction_id、point_id 不重复）就在本节点做；被拒按原因修正后在本节点重新提交，读图通过后冻结，配对节点不再改它。",
-            "看不清产品外观时 outcome 写 unreadable 并说明原因，不给点位、不猜坐标；image_digest 原样抄这张图片引用的摘要。",
-            "读图只依赖这张图和需求的 reaction，不等硬件选型，也不反向约束选型。"
+            "看不清产品外观时 outcome 写 unreadable 并说明原因，不给点位、不猜坐标；image_digest 只用 primary 原图引用的摘要；所有像素只报原图，spatial_reference 仅辅助理解空间和结构。",
+            "读图消费 primary 原图、可用的内部 spatial_reference 和需求 reaction；create/modify 等同图确认与内部视图结果，不等硬件选型，也不反向约束选型。宿主有实测 primary_image_px 时省略 image_px，由宿主注入。纠错保留有效面四角和因面归属被拒点的像素范围，不拉大面或缩小点求通过；重新归面或撤回并以 point_id 写入 unknowns。"
           ]
         },
         "pair": {