@wowok/agent-mcp 2.7.2 → 2.7.4

package/dist/schemas/local_mark_operation.output.json

@@ -1,867 +1,1414 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://wowok.net/schemas/local_mark_operation.json",
+  "$id": "https://wowok.net/schemas/local_mark_operation.output.json",
   "title": "Local Mark Operations",
-  "description": "Manage ID names and tags stored locally",
-  "$ref": "#/definitions/local_mark_operation",
-  "definitions": {
-    "local_mark_operation": {
-      "type": "object",
-      "properties": {
-        "result": {
-          "anyOf": [
-            {
+  "description": "Local mark operation output wrapped schema",
+  "type": "object",
+  "properties": {
+    "result": {
+      "oneOf": [
+        {
+          "type": "object",
+          "properties": {
+            "status": {
+              "type": "string",
+              "const": "success"
+            },
+            "data": {
               "type": "object",
               "properties": {
-                "status": {
-                  "type": "string",
-                  "const": "success"
+                "clear": {
+                  "description": "Whether all marks were successfully removed",
+                  "type": "boolean"
                 },
-                "data": {
-                  "type": "object",
-                  "properties": {
-                    "clear": {
-                      "type": "boolean",
-                      "description": "Whether all marks were successfully removed"
-                    },
-                    "add": {
-                      "type": "array",
-                      "items": {
-                        "type": "object",
-                        "properties": {
-                          "name": {
-                            "type": "string",
-                            "maxLength": 64,
-                            "description": "Mark name (max 64 bcs characters)"
-                          },
-                          "address": {
-                            "type": "string",
-                            "description": "Valid ID: 0x prefix + 64 hex characters, or builtin ID (0x5-0x9, 0xa, 0xc, 0xd, 0x403, 0xaaa, 0xaab, 0xacc)"
-                          },
-                          "tags": {
-                            "type": "array",
-                            "items": {
-                              "type": "string",
-                              "maxLength": 64
-                            },
-                            "maxItems": 50,
-                            "description": "Tags for categorization (max 50 tags, each max 64 bcs characters)"
-                          },
-                          "createdAt": {
-                            "type": "number",
-                            "description": "Unix timestamp (ms) when this mark was created"
-                          },
-                          "updatedAt": {
-                            "type": "number",
-                            "description": "Unix timestamp (ms) when this mark was last modified"
-                          }
-                        },
-                        "required": [
-                          "address"
-                        ],
-                        "additionalProperties": false,
-                        "description": "LOCAL PRIVATE: Local mark data structure for storing address names and tags privately on your device. This data is NEVER published to the blockchain. CROSS-NETWORK ISOLATION (DOC-02): LocalMark names are scoped per network — the same name 'my-service' can map to different addresses on testnet vs mainnet. When switching networks (e.g., testnet→mainnet deployment), re-create marks with the same names pointing to the new mainnet addresses. This enables name-based object references that work identically across networks without code changes."
+                "add": {
+                  "description": "List of added mark data",
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "name": {
+                        "description": "Mark name (max 64 bcs characters)",
+                        "type": "string",
+                        "maxLength": 64
                       },
-                      "description": "List of added mark data"
-                    },
-                    "remove": {
-                      "type": "array",
-                      "items": {
-                        "$ref": "#/definitions/local_mark_operation/properties/result/anyOf/0/properties/data/properties/add/items"
+                      "address": {
+                        "type": "string",
+                        "description": "Valid ID: 0x prefix + 64 hex characters, or builtin ID (0x5-0x9, 0xa, 0xc, 0xd, 0x403, 0xaaa, 0xaab, 0xacc)"
                       },
-                      "description": "List of removed mark data"
-                    }
-                  },
-                  "additionalProperties": false,
-                  "description": "Success result data"
-                }
-              },
-              "required": [
-                "status",
-                "data"
-              ],
-              "additionalProperties": false
-            },
-            {
-              "type": "object",
-              "properties": {
-                "status": {
-                  "type": "string",
-                  "const": "error"
-                },
-                "error": {
-                  "type": "string",
-                  "description": "Error message"
-                },
-                "error_code": {
-                  "type": "string",
-                  "enum": [
-                    "invalid_parameter",
-                    "guard_rejected",
-                    "state_conflict",
-                    "insufficient_balance",
-                    "object_not_found",
-                    "permission_denied",
-                    "immutable_violation",
-                    "network_error",
-                    "rate_limit",
-                    "gas_exceeded",
-                    "bcs_error",
-                    "signature_error",
-                    "config_error",
-                    "wip_verification_failed",
-                    "unknown"
-                  ],
-                  "description": "Error classification for programmatic recovery"
-                },
-                "retryable": {
-                  "type": "boolean",
-                  "description": "Whether the operation can be retried as-is"
+                      "tags": {
+                        "description": "Tags for categorization (max 50 tags, each max 64 bcs characters)",
+                        "maxItems": 50,
+                        "type": "array",
+                        "items": {
+                          "type": "string",
+                          "maxLength": 64
+                        }
+                      },
+                      "createdAt": {
+                        "description": "Unix timestamp (ms) when this mark was created",
+                        "type": "number"
+                      },
+                      "updatedAt": {
+                        "description": "Unix timestamp (ms) when this mark was last modified",
+                        "type": "number"
+                      }
+                    },
+                    "required": [
+                      "address"
+                    ],
+                    "additionalProperties": false,
+                    "description": "LOCAL PRIVATE: Local mark data structure for storing address names and tags privately on your device. This data is NEVER published to the blockchain. CROSS-NETWORK ISOLATION (DOC-02): LocalMark names are scoped per network — the same name 'my-service' can map to different addresses on testnet vs mainnet. When switching networks (e.g., testnet→mainnet deployment), re-create marks with the same names pointing to the new mainnet addresses. This enables name-based object references that work identically across networks without code changes."
+                  }
                 },
-                "recovery_hint": {
-                  "type": "string",
-                  "description": "Recovery suggestion for AI or user"
+                "remove": {
+                  "description": "List of removed mark data",
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "name": {
+                        "description": "Mark name (max 64 bcs characters)",
+                        "type": "string",
+                        "maxLength": 64
+                      },
+                      "address": {
+                        "type": "string",
+                        "description": "Valid ID: 0x prefix + 64 hex characters, or builtin ID (0x5-0x9, 0xa, 0xc, 0xd, 0x403, 0xaaa, 0xaab, 0xacc)"
+                      },
+                      "tags": {
+                        "description": "Tags for categorization (max 50 tags, each max 64 bcs characters)",
+                        "maxItems": 50,
+                        "type": "array",
+                        "items": {
+                          "type": "string",
+                          "maxLength": 64
+                        }
+                      },
+                      "createdAt": {
+                        "description": "Unix timestamp (ms) when this mark was created",
+                        "type": "number"
+                      },
+                      "updatedAt": {
+                        "description": "Unix timestamp (ms) when this mark was last modified",
+                        "type": "number"
+                      }
+                    },
+                    "required": [
+                      "address"
+                    ],
+                    "additionalProperties": false,
+                    "description": "LOCAL PRIVATE: Local mark data structure for storing address names and tags privately on your device. This data is NEVER published to the blockchain. CROSS-NETWORK ISOLATION (DOC-02): LocalMark names are scoped per network — the same name 'my-service' can map to different addresses on testnet vs mainnet. When switching networks (e.g., testnet→mainnet deployment), re-create marks with the same names pointing to the new mainnet addresses. This enables name-based object references that work identically across networks without code changes."
+                  }
                 }
               },
-              "required": [
-                "status",
-                "error"
-              ],
-              "additionalProperties": false
+              "additionalProperties": false,
+              "description": "Success result data"
             }
+          },
+          "required": [
+            "status",
+            "data"
           ],
-          "description": "Local mark operation output schema with discriminator"
+          "additionalProperties": false
         },
-        "semantic": {
+        {
           "type": "object",
           "properties": {
-            "intent": {
+            "status": {
               "type": "string",
-              "description": "Inferred user intent / operation goal. Constraint: snake_case string. Relation: derived from operation_type + data signals. Example: 'publish_service'"
+              "const": "error"
             },
-            "status": {
+            "error": {
               "type": "string",
-              "enum": [
-                "success",
-                "partial",
-                "failed",
-                "pending_input"
-              ],
-              "description": "Business-level status (not raw tx status). 'pending_input' = needs Guard submission. Example: 'success'"
+              "description": "Error message"
             },
-            "summary": {
+            "error_code": {
+              "description": "Error classification for programmatic recovery",
               "type": "string",
-              "description": "One-sentence human-readable summary of what happened. AI should read this first. Example: 'Successfully published Service my-shop with Machine bound'"
+              "enum": [
+                "invalid_parameter",
+                "guard_rejected",
+                "state_conflict",
+                "insufficient_balance",
+                "object_not_found",
+                "permission_denied",
+                "immutable_violation",
+                "network_error",
+                "rate_limit",
+                "gas_exceeded",
+                "bcs_error",
+                "signature_error",
+                "config_error",
+                "wip_verification_failed",
+                "unknown"
+              ]
             },
-            "created": {
-              "type": "array",
-              "items": {
+            "retryable": {
+              "description": "Whether the operation can be retried as-is",
+              "type": "boolean"
+            },
+            "recovery_hint": {
+              "description": "Recovery suggestion for AI or user",
+              "type": "string"
+            }
+          },
+          "required": [
+            "status",
+            "error"
+          ],
+          "additionalProperties": false
+        }
+      ],
+      "description": "Local mark operation output schema with discriminator"
+    },
+    "semantic": {
+      "description": "Business semantic summary for local mark operation",
+      "type": "object",
+      "properties": {
+        "intent": {
+          "type": "string",
+          "description": "Inferred user intent / operation goal. Constraint: snake_case string. Relation: derived from operation_type + data signals. Example: 'publish_service'"
+        },
+        "status": {
+          "type": "string",
+          "enum": [
+            "success",
+            "partial",
+            "failed",
+            "pending_input"
+          ],
+          "description": "Business-level status (not raw tx status). 'pending_input' = needs Guard submission. Example: 'success'"
+        },
+        "summary": {
+          "type": "string",
+          "description": "One-sentence human-readable summary of what happened. AI should read this first. Example: 'Successfully published Service my-shop with Machine bound'"
+        },
+        "created": {
+          "description": "Objects newly created in this operation, tagged with roles",
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string",
+                "description": "Object ID (64-hex with 0x prefix). Identifies the on-chain object. Example: '0xa1d4...'"
+              },
+              "name": {
+                "description": "Local mark name if assigned, else null. Relation: resolved via local_mark_operation. Example: 'my-shop' or null",
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "role": {
+                "type": "string",
+                "enum": [
+                  "Permission",
+                  "Guard",
+                  "Machine",
+                  "Progress",
+                  "Service",
+                  "Order",
+                  "Allocation",
+                  "Arbitration",
+                  "ArbCase",
+                  "Messenger",
+                  "Contact",
+                  "Demand",
+                  "Reward",
+                  "Personal",
+                  "Repository",
+                  "Treasury",
+                  "Discount",
+                  "Payment",
+                  "Passport",
+                  "Proof",
+                  "Other"
+                ],
+                "description": "Business role of the object in the dependency graph. Constraint: enum of 21 values. Relation: derived from objectType last segment; drives Plan/Verify Loop positioning. Example: 'Service'"
+              },
+              "relation": {
+                "description": "Relationship to another object in the dependency graph",
                 "type": "object",
                 "properties": {
-                  "id": {
-                    "type": "string",
-                    "description": "Object ID (64-hex with 0x prefix). Identifies the on-chain object. Example: '0xa1d4...'"
-                  },
-                  "name": {
-                    "type": [
-                      "string",
-                      "null"
-                    ],
-                    "description": "Local mark name if assigned, else null. Relation: resolved via local_mark_operation. Example: 'my-shop' or null"
-                  },
-                  "role": {
-                    "type": "string",
-                    "enum": [
-                      "Permission",
-                      "Guard",
-                      "Machine",
-                      "Progress",
-                      "Service",
-                      "Order",
-                      "Allocation",
-                      "Arbitration",
-                      "ArbCase",
-                      "Messenger",
-                      "Contact",
-                      "Demand",
-                      "Reward",
-                      "Personal",
-                      "Repository",
-                      "Treasury",
-                      "Discount",
-                      "Other"
-                    ],
-                    "description": "Business role of the object in the dependency graph. Constraint: enum of 18 values. Relation: derived from objectType last segment; drives Plan/Verify Loop positioning. Example: 'Service'"
-                  },
-                  "relation": {
-                    "type": "object",
-                    "properties": {
-                      "parent": {
-                        "type": [
-                          "string",
-                          "null"
-                        ],
-                        "description": "Parent object ID, if this object belongs to another (e.g. Machine belongs to Service). Example: '0x123...' or null"
+                  "parent": {
+                    "description": "Parent object ID, if this object belongs to another (e.g. Machine belongs to Service). Example: '0x123...' or null",
+                    "anyOf": [
+                      {
+                        "type": "string"
                       },
-                      "relation_type": {
-                        "type": "string",
-                        "enum": [
-                          "machine_of",
-                          "guard_of",
-                          "allocator_of",
-                          "permission_of",
-                          "progress_of",
-                          "allocation_of",
-                          "arb_of",
-                          "other"
-                        ],
-                        "description": "How this object relates to its parent. Example: 'machine_of'"
+                      {
+                        "type": "null"
                       }
-                    },
-                    "additionalProperties": false,
-                    "description": "Relationship to another object in the dependency graph"
+                    ]
                   },
-                  "immutable": {
-                    "type": "boolean",
-                    "description": "Whether the object has entered an immutable state (e.g. Service published). Constraint: true after publish. Example: true"
+                  "relation_type": {
+                    "description": "How this object relates to its parent. Example: 'machine_of'",
+                    "type": "string",
+                    "enum": [
+                      "machine_of",
+                      "guard_of",
+                      "allocator_of",
+                      "permission_of",
+                      "progress_of",
+                      "allocation_of",
+                      "arb_of",
+                      "other"
+                    ]
                   }
                 },
-                "required": [
-                  "id",
-                  "role"
-                ],
-                "additionalProperties": false,
-                "description": "An object tagged with its business role and relationship within the object dependency graph"
+                "additionalProperties": false
               },
-              "description": "Objects newly created in this operation, tagged with roles"
+              "immutable": {
+                "description": "Whether the object has entered an immutable state (e.g. Service published). Constraint: true after publish. Example: true",
+                "type": "boolean"
+              }
             },
-            "modified": {
-              "type": "array",
-              "items": {
-                "$ref": "#/definitions/local_mark_operation/properties/semantic/properties/created/items"
+            "required": [
+              "id",
+              "role"
+            ],
+            "additionalProperties": false,
+            "description": "An object tagged with its business role and relationship within the object dependency graph"
+          }
+        },
+        "modified": {
+          "description": "Objects mutated in this operation, tagged with roles",
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string",
+                "description": "Object ID (64-hex with 0x prefix). Identifies the on-chain object. Example: '0xa1d4...'"
               },
-              "description": "Objects mutated in this operation, tagged with roles"
-            },
-            "released": {
-              "type": "array",
-              "items": {
+              "name": {
+                "description": "Local mark name if assigned, else null. Relation: resolved via local_mark_operation. Example: 'my-shop' or null",
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "role": {
+                "type": "string",
+                "enum": [
+                  "Permission",
+                  "Guard",
+                  "Machine",
+                  "Progress",
+                  "Service",
+                  "Order",
+                  "Allocation",
+                  "Arbitration",
+                  "ArbCase",
+                  "Messenger",
+                  "Contact",
+                  "Demand",
+                  "Reward",
+                  "Personal",
+                  "Repository",
+                  "Treasury",
+                  "Discount",
+                  "Payment",
+                  "Passport",
+                  "Proof",
+                  "Other"
+                ],
+                "description": "Business role of the object in the dependency graph. Constraint: enum of 21 values. Relation: derived from objectType last segment; drives Plan/Verify Loop positioning. Example: 'Service'"
+              },
+              "relation": {
+                "description": "Relationship to another object in the dependency graph",
                 "type": "object",
                 "properties": {
-                  "amount": {
-                    "type": "string",
-                    "description": "Amount change as stringified integer (smallest unit). Negative=spend, positive=receive. Example: '-10000000000'"
-                  },
-                  "coinType": {
-                    "type": "string",
-                    "description": "Coin type tag (format: {address}::{module}::{struct}). Example: '0x2::wow::WOW'"
+                  "parent": {
+                    "description": "Parent object ID, if this object belongs to another (e.g. Machine belongs to Service). Example: '0x123...' or null",
+                    "anyOf": [
+                      {
+                        "type": "string"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
                   },
-                  "role": {
+                  "relation_type": {
+                    "description": "How this object relates to its parent. Example: 'machine_of'",
                     "type": "string",
                     "enum": [
-                      "payment",
-                      "refund",
-                      "change",
-                      "compensation",
-                      "reward",
-                      "gas",
-                      "deposit",
-                      "release",
+                      "machine_of",
+                      "guard_of",
+                      "allocator_of",
+                      "permission_of",
+                      "progress_of",
+                      "allocation_of",
+                      "arb_of",
                       "other"
-                    ],
-                    "description": "Business role of this fund movement. Constraint: enum of 9 values. Relation: derived from operation context. Example: 'payment'"
+                    ]
+                  }
+                },
+                "additionalProperties": false
+              },
+              "immutable": {
+                "description": "Whether the object has entered an immutable state (e.g. Service published). Constraint: true after publish. Example: true",
+                "type": "boolean"
+              }
+            },
+            "required": [
+              "id",
+              "role"
+            ],
+            "additionalProperties": false,
+            "description": "An object tagged with its business role and relationship within the object dependency graph"
+          }
+        },
+        "released": {
+          "description": "Fund movements in this operation, tagged with roles",
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "amount": {
+                "type": "string",
+                "description": "Amount change as stringified integer (smallest unit). Negative=spend, positive=receive. Example: '-10000000000'"
+              },
+              "coinType": {
+                "type": "string",
+                "description": "Coin type tag (format: {address}::{module}::{struct}). Example: '0x2::wow::WOW'"
+              },
+              "role": {
+                "type": "string",
+                "enum": [
+                  "payment",
+                  "refund",
+                  "change",
+                  "compensation",
+                  "reward",
+                  "gas",
+                  "deposit",
+                  "release",
+                  "other"
+                ],
+                "description": "Business role of this fund movement. Constraint: enum of 9 values. Relation: derived from operation context. Example: 'payment'"
+              },
+              "from": {
+                "description": "Sender address if known. Example: '0xabc...' or null",
+                "anyOf": [
+                  {
+                    "type": "string"
                   },
-                  "from": {
-                    "type": [
-                      "string",
-                      "null"
-                    ],
-                    "description": "Sender address if known. Example: '0xabc...' or null"
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "to": {
+                "description": "Recipient address if known. Example: '0xdef...' or null",
+                "anyOf": [
+                  {
+                    "type": "string"
                   },
-                  "to": {
-                    "type": [
-                      "string",
-                      "null"
-                    ],
-                    "description": "Recipient address if known. Example: '0xdef...' or null"
+                  {
+                    "type": "null"
                   }
-                },
-                "required": [
-                  "amount",
-                  "coinType",
-                  "role"
+                ]
+              }
+            },
+            "required": [
+              "amount",
+              "coinType",
+              "role"
+            ],
+            "additionalProperties": false,
+            "description": "A fund movement tagged with its business role"
+          }
+        },
+        "events": {
+          "description": "On-chain events annotated with business semantics (S-8)",
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "event_type": {
+                "type": "string",
+                "description": "Raw on-chain event type tag. Example: '0x2::service::ServicePublishedEvent'"
+              },
+              "business_meaning": {
+                "type": "string",
+                "description": "Human-readable business meaning. Example: 'Service has been published and is now immutable'"
+              },
+              "category": {
+                "type": "string",
+                "enum": [
+                  "lifecycle",
+                  "state_change",
+                  "fund_flow",
+                  "permission",
+                  "guard",
+                  "other"
                 ],
-                "additionalProperties": false,
-                "description": "A fund movement tagged with its business role"
+                "description": "Business category. Constraint: enum of 6 values. Example: 'lifecycle'"
+              },
+              "related_object": {
+                "description": "Object ID the event relates to, if extractable. Example: '0x123...'",
+                "type": "string"
+              },
+              "side_effect": {
+                "description": "Side effect description for AI. Example: 'Customers can now place orders against this Service'",
+                "type": "string"
+              }
+            },
+            "required": [
+              "event_type",
+              "business_meaning",
+              "category"
+            ],
+            "additionalProperties": false,
+            "description": "An on-chain event annotated with business semantics"
+          }
+        },
+        "next_actions": {
+          "description": "Recommended next actions to drive the workflow forward",
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "action": {
+                "type": "string",
+                "description": "Recommended next action. Example: 'add sales products'"
+              },
+              "reason": {
+                "type": "string",
+                "description": "Why this action is recommended. Example: 'Service has no products; customers cannot order'"
+              },
+              "tool": {
+                "description": "MCP tool to use, if applicable. Example: 'onchain_operations'",
+                "type": "string"
+              },
+              "prerequisite": {
+                "description": "Condition that must hold before this action. Example: 'Service must be created first'",
+                "type": "string"
+              },
+              "priority": {
+                "type": "string",
+                "enum": [
+                  "required",
+                  "recommended",
+                  "optional"
+                ],
+                "description": "Priority. Constraint: enum. Example: 'required'"
+              }
+            },
+            "required": [
+              "action",
+              "reason",
+              "priority"
+            ],
+            "additionalProperties": false,
+            "description": "A recommended next action with priority and rationale"
+          }
+        },
+        "warnings": {
+          "description": "Business-level warnings. Example: 'order_allocators not configured; order funds cannot be distributed'",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "experience": {
+          "description": "Experience layer feedback from past operations (Phase 2 Topic 2)",
+          "type": "object",
+          "properties": {
+            "advice": {
+              "description": "Advice from past experience. Example: 'Last time you forgot to set buy_guard; add it before publishing'",
+              "type": "string"
+            },
+            "avoid": {
+              "description": "Pitfalls to avoid based on history. Example: ['Guard rejection on delivery_proof']",
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "relevance": {
+              "description": "Relevance score 0-1 of the matched experience. Example: 0.85",
+              "type": "number",
+              "minimum": 0,
+              "maximum": 1
+            },
+            "matched_scenario": {
+              "description": "Matched historical scenario. Example: 'publish_service_freelance'",
+              "type": "string"
+            }
+          },
+          "additionalProperties": false
+        },
+        "service_status": {
+          "description": "Phase 2 runtime service status (populated when semantic_rich is enabled). Lets AI see active services in each response.",
+          "type": "object",
+          "properties": {
+            "active": {
+              "type": "array",
+              "items": {
+                "type": "string"
               },
-              "description": "Fund movements in this operation, tagged with roles"
+              "description": "Phase 2 services currently active (enabled). Example: ['confirm_gate','project_service','experience_layer']"
+            },
+            "inactive": {
+              "description": "Phase 2 services currently inactive (can be toggled via config_operation). Example: ['harness','graph_persist']",
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          },
+          "required": [
+            "active"
+          ],
+          "additionalProperties": false
+        },
+        "customer_advice": {
+          "description": "Buyer-side advice (Phase 3 C-3.3). Populated when customer_intelligence service is enabled AND operation is order/query on a Service. Contains risk_score, recommendations, reminders, and preference_match.",
+          "type": "object",
+          "properties": {
+            "risk_score": {
+              "description": "Composite risk score 0-100 (higher = safer). Relation: from risk-assessment.ts 4-dimension scoring. Example: 75",
+              "type": "number",
+              "minimum": 0,
+              "maximum": 100
             },
-            "events": {
+            "risk_level": {
+              "description": "Risk level bucket. 'high' = strongly discourage purchase. Example: 'medium_high'",
+              "type": "string",
+              "enum": [
+                "low",
+                "medium_low",
+                "medium_high",
+                "high"
+              ]
+            },
+            "recommendations": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Actionable recommendations for the buyer. Example: ['Require merchant to configure arbitration','Negotiate refund terms via Messenger']"
+            },
+            "reminders": {
               "type": "array",
               "items": {
                 "type": "object",
                 "properties": {
-                  "event_type": {
+                  "id": {
                     "type": "string",
-                    "description": "Raw on-chain event type tag. Example: '0x2::service::ServicePublishedEvent'"
+                    "description": "Reminder rule id. Example: 'high_risk_score'"
                   },
-                  "business_meaning": {
+                  "stage": {
                     "type": "string",
-                    "description": "Human-readable business meaning. Example: 'Service has been published and is now immutable'"
+                    "enum": [
+                      "browse",
+                      "evaluate",
+                      "preorder",
+                      "in_progress",
+                      "complete",
+                      "after_sale"
+                    ],
+                    "description": "Order lifecycle stage when this reminder fires. Example: 'evaluate'"
                   },
-                  "category": {
+                  "priority": {
                     "type": "string",
                     "enum": [
-                      "lifecycle",
-                      "state_change",
-                      "fund_flow",
-                      "permission",
-                      "guard",
-                      "other"
+                      "required",
+                      "recommended",
+                      "info",
+                      "reminder"
                     ],
-                    "description": "Business category. Constraint: enum of 6 values. Example: 'lifecycle'"
+                    "description": "Priority. 'required' = blocks purchase; 'recommended' = strong caution. Example: 'required'"
                   },
-                  "related_object": {
+                  "message": {
                     "type": "string",
-                    "description": "Object ID the event relates to, if extractable. Example: '0x123...'"
+                    "description": "Human-readable reminder message. Example: 'Composite risk score 25/100, strongly discourage purchase'"
                   },
-                  "side_effect": {
-                    "type": "string",
-                    "description": "Side effect description for AI. Example: 'Customers can now place orders against this Service'"
+                  "action": {
+                    "description": "Suggested next action. Example: 'require merchant to bind Arbitration before ordering'",
+                    "type": "string"
                   }
                 },
                 "required": [
-                  "event_type",
-                  "business_meaning",
-                  "category"
+                  "id",
+                  "stage",
+                  "priority",
+                  "message"
                 ],
                 "additionalProperties": false,
-                "description": "An on-chain event annotated with business semantics"
+                "description": "A buyer-side reminder triggered at a specific order lifecycle stage (Phase 3 C-3)."
+              },
+              "description": "Stage-specific reminders (deduped, sorted by priority, capped to 3 high-risk). Example: [{priority:'required', message:'Ambiguous Guard must be human-reviewed'}]"
+            },
+            "preference_match": {
+              "description": "Service-to-preference match (populated when user preferences exist). Example: {score:75, matches:[...], mismatches:[...]}",
+              "type": "object",
+              "properties": {
+                "score": {
+                  "type": "number",
+                  "minimum": 0,
+                  "maximum": 100,
+                  "description": "Match score 0-100 (higher = better fit). Example: 75"
+                },
+                "matches": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "Aspects that match user preferences. Example: ['Price 10% below average','Has arbitration']"
+                },
+                "mismatches": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "Aspects that mismatch user preferences. Example: ['Delivery cycle exceeds expectation']"
+                }
+              },
+              "required": [
+                "score",
+                "matches",
+                "mismatches"
+              ],
+              "additionalProperties": false
+            }
+          },
+          "required": [
+            "recommendations",
+            "reminders"
+          ],
+          "additionalProperties": false
+        },
+        "evolution_context": {
+          "description": "Phase 4 industry evolution context (populated when industry_evolution service is enabled). Provides AI with industry health signals and evolution advice.",
+          "type": "object",
+          "properties": {
+            "industry_signal": {
+              "description": "Industry evolution signal summary. Example: 'Industry health 82/100 (healthy); 25 cumulative industry signals'",
+              "type": "string"
+            },
+            "evolution_advice": {
+              "description": "Evolution advice for the current operation. Example: 'Recommend mandatory arbitration + compensation fund + delivery Guard'",
+              "type": "string"
+            },
+            "confidence": {
+              "type": "number",
+              "minimum": 0,
+              "maximum": 1,
+              "description": "Confidence of the evolution context 0-1. <0.5 means no data yet. Example: 0.75"
+            },
+            "health_score": {
+              "description": "Industry health score 0-100 if available. Example: 82",
+              "type": "number",
+              "minimum": 0,
+              "maximum": 100
+            },
+            "pending_suggestions": {
+              "description": "Count of pending industry update suggestions (filtered by role if role is set). Example: 3",
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991
+            },
+            "intent": {
+              "description": "Phase 4 P4-6.C: Current business intent driving the scoring model. Absent = 'default'. Example: 'growth'",
+              "type": "string",
+              "enum": [
+                "default",
+                "growth",
+                "retention",
+                "compliance",
+                "efficiency",
+                "trust_building",
+                "custom"
+              ]
+            },
+            "role_advice": {
+              "description": "Phase 4 P4-6.C: Role-targeted advice strings (merchant/customer/prospect/supplier/collaborator/arbitrator). Example: ['Strengthen loyalty flywheel','Optimize first-order conversion']",
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "role": {
+              "description": "Phase 4 P4-6.C: Role used for advice routing. Example: 'merchant'",
+              "type": "string",
+              "enum": [
+                "merchant",
+                "customer",
+                "prospect",
+                "supplier",
+                "collaborator",
+                "arbitrator"
+              ]
+            }
+          },
+          "required": [
+            "confidence"
+          ],
+          "additionalProperties": false
+        },
+        "guard_advice": {
+          "description": "Phase 5 Guard capability advice (populated when user intent involves Guard). Provides puzzle status, scene matching, suggested patterns, available queries, risk warnings, and confirmation text. AI uses this to guide Guard design dialogue (R1-R10).",
+          "type": "object",
+          "properties": {
+            "current_round": {
+              "description": "Current R1-R10 dialogue round. R1=intent, R2=table, R3=tree, R4=rely, R5=binding, R6=review, R7=CREATE, R8=test, R9=bind, R10=verify. Example: 'R3'",
+              "type": "string",
+              "enum": [
+                "R1",
+                "R2",
+                "R3",
+                "R4",
+                "R5",
+                "R6",
+                "R7",
+                "R8",
+                "R9",
+                "R10"
+              ]
+            },
+            "puzzle_status": {
+              "description": "Information puzzle completeness (6 dimensions). Missing dimensions need user input before CREATE.",
+              "type": "object",
+              "properties": {
+                "intent": {
+                  "type": "boolean",
+                  "description": "Intent dimension complete (action + rule + failure conditions)"
+                },
+                "binding": {
+                  "type": "boolean",
+                  "description": "Binding dimension complete (host object + field + circular ref)"
+                },
+                "data": {
+                  "type": "boolean",
+                  "description": "Data dimension complete (table entries + witnesses)"
+                },
+                "query": {
+                  "type": "boolean",
+                  "description": "Query dimension complete (query instructions if needed)"
+                },
+                "logic": {
+                  "type": "boolean",
+                  "description": "Logic dimension complete (root node returns Bool)"
+                },
+                "constraints": {
+                  "type": "boolean",
+                  "description": "Constraints dimension complete (10 Pitfalls checked)"
+                }
               },
-              "description": "On-chain events annotated with business semantics (S-8)"
+              "required": [
+                "intent",
+                "binding",
+                "data",
+                "query",
+                "logic",
+                "constraints"
+              ],
+              "additionalProperties": false
+            },
+            "matched_scene": {
+              "description": "Matched Guard scene id from the 8 binding scenarios ledger. Example: 'machine_forward_guard'",
+              "type": "string"
+            },
+            "scene_description": {
+              "description": "Human-readable scene description. Example: 'Workflow node forward validation (Forward.guard)'",
+              "type": "string"
             },
-            "next_actions": {
+            "scene_constraints": {
+              "description": "Special constraints for the matched scene. Example: ['Forward.guard cannot be modified after Machine is published']",
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "suggested_patterns": {
+              "description": "Suggested Guard patterns based on user intent. Example: ['time lock','progress status check']",
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "available_queries": {
+              "description": "Available query instructions for the current context (subset of 375 GUARDQUERY entries)",
               "type": "array",
               "items": {
                 "type": "object",
                 "properties": {
-                  "action": {
-                    "type": "string",
-                    "description": "Recommended next action. Example: 'add sales products'"
+                  "id": {
+                    "type": "integer",
+                    "minimum": -9007199254740991,
+                    "maximum": 9007199254740991,
+                    "description": "Query instruction ID. Example: 1253"
                   },
-                  "reason": {
+                  "name": {
                     "type": "string",
-                    "description": "Why this action is recommended. Example: 'Service has no products; customers cannot order'"
+                    "description": "Query instruction name. Example: 'progress.current'"
                   },
-                  "tool": {
+                  "objectType": {
                     "type": "string",
-                    "description": "MCP tool to use, if applicable. Example: 'onchain_operations'"
+                    "description": "Target object type. Example: 'Progress'"
                   },
-                  "prerequisite": {
+                  "returnType": {
                     "type": "string",
-                    "description": "Condition that must hold before this action. Example: 'Service must be created first'"
+                    "description": "Return value type. Example: 'String'"
                   },
-                  "priority": {
-                    "type": "string",
-                    "enum": [
-                      "required",
-                      "recommended",
-                      "optional"
-                    ],
-                    "description": "Priority. Constraint: enum. Example: 'required'"
+                  "description": {
+                    "description": "Query description",
+                    "type": "string"
                   }
                 },
                 "required": [
-                  "action",
-                  "reason",
-                  "priority"
+                  "id",
+                  "name",
+                  "objectType",
+                  "returnType"
                 ],
                 "additionalProperties": false,
-                "description": "A recommended next action with priority and rationale"
-              },
-              "description": "Recommended next actions to drive the workflow forward"
+                "description": "A Guard query instruction available for the current context (subset of GUARDQUERY 375 entries)."
+              }
             },
-            "warnings": {
+            "risk_warnings": {
+              "description": "Risk warnings for the current Guard design. Example: ['Guard cannot be modified after creation','Time lock test uses 1000ms']",
               "type": "array",
               "items": {
                 "type": "string"
-              },
-              "description": "Business-level warnings. Example: 'order_allocators not configured; order funds cannot be distributed'"
+              }
+            },
+            "pending_questions": {
+              "description": "Questions for the user to complete the puzzle. Example: ['Which Host Object will the Guard bind to?']",
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "confirmation_text": {
+              "description": "Structured semantic confirmation text for user review (generated when puzzle is complete). User must explicitly confirm before CREATE.",
+              "type": "string"
             },
-            "experience": {
+            "test_result": {
+              "description": "gen_passport static test result. Must pass before CREATE.",
               "type": "object",
               "properties": {
-                "advice": {
+                "status": {
                   "type": "string",
-                  "description": "Advice from past experience. Example: 'Last time you forgot to set buy_guard; add it before publishing'"
-                },
-                "avoid": {
-                  "type": "array",
-                  "items": {
-                    "type": "string"
-                  },
-                  "description": "Pitfalls to avoid based on history. Example: ['Guard rejection on delivery_proof']"
+                  "enum": [
+                    "pass",
+                    "fail",
+                    "not_tested"
+                  ]
                 },
-                "relevance": {
-                  "type": "number",
-                  "minimum": 0,
-                  "maximum": 1,
-                  "description": "Relevance score 0-1 of the matched experience. Example: 0.85"
+                "failure_node": {
+                  "description": "Node that caused failure (if fail)",
+                  "type": "string"
                 },
-                "matched_scenario": {
-                  "type": "string",
-                  "description": "Matched historical scenario. Example: 'publish_service_freelance'"
+                "passport_id": {
+                  "description": "Generated Passport ID (if pass)",
+                  "type": "string"
                 }
               },
-              "additionalProperties": false,
-              "description": "Experience layer feedback from past operations (Phase 2 Topic 2)"
+              "required": [
+                "status"
+              ],
+              "additionalProperties": false
             },
-            "service_status": {
+            "risk_assessment": {
+              "description": "Business-layer risk assessment (game theory, data source trust, logic gaps). Populated during Guard design to warn about business risks beyond syntax.",
               "type": "object",
               "properties": {
-                "active": {
+                "overall_risk": {
+                  "type": "string",
+                  "enum": [
+                    "critical",
+                    "high",
+                    "medium",
+                    "low",
+                    "info"
+                  ],
+                  "description": "Overall risk level (highest from all risks)"
+                },
+                "risk_count": {
+                  "type": "integer",
+                  "minimum": -9007199254740991,
+                  "maximum": 9007199254740991,
+                  "description": "Total number of detected risks"
+                },
+                "critical_count": {
+                  "type": "integer",
+                  "minimum": -9007199254740991,
+                  "maximum": 9007199254740991,
+                  "description": "Number of critical risks"
+                },
+                "high_count": {
+                  "type": "integer",
+                  "minimum": -9007199254740991,
+                  "maximum": 9007199254740991,
+                  "description": "Number of high risks"
+                },
+                "needs_human_review": {
+                  "type": "boolean",
+                  "description": "Whether human review is required (critical or 2+ high risks)"
+                },
+                "top_risks": {
                   "type": "array",
                   "items": {
                     "type": "string"
                   },
-                  "description": "Phase 2 services currently active (enabled). Example: ['confirm_gate','project_service','experience_layer']"
+                  "description": "Top risk titles (critical and high, max 3)"
                 },
-                "inactive": {
-                  "type": "array",
-                  "items": {
+                "stakeholder_advice": {
+                  "description": "Per-stakeholder advice. Key=stakeholder (customer/provider/arbitrator/claimant), value=advice list",
+                  "type": "object",
+                  "propertyNames": {
                     "type": "string"
                   },
-                  "description": "Phase 2 services currently inactive (can be toggled via config_operation). Example: ['harness','graph_persist']"
+                  "additionalProperties": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    }
+                  }
                 }
               },
               "required": [
-                "active"
+                "overall_risk",
+                "risk_count",
+                "critical_count",
+                "high_count",
+                "needs_human_review",
+                "top_risks"
               ],
-              "additionalProperties": false,
-              "description": "Phase 2 runtime service status (populated when semantic_rich is enabled). Lets AI see active services in each response."
+              "additionalProperties": false
+            }
+          },
+          "additionalProperties": false
+        },
+        "workflow_guidance": {
+          "description": "K3 permission-aware workflow guidance: current node + ALL reachable next nodes with their operator/permission/guard + K3 recommendation. Populated when a Progress (or Order with Progress) is queried and after progress operate. AI must read this BEFORE proposing the next workflow operation.",
+          "type": "object",
+          "properties": {
+            "current_node": {
+              "type": "string",
+              "description": "Current node of the Progress. Example: 'serving'"
             },
-            "customer_advice": {
-              "type": "object",
-              "properties": {
-                "risk_score": {
-                  "type": "number",
-                  "minimum": 0,
-                  "maximum": 100,
-                  "description": "Composite risk score 0-100 (higher = safer). Relation: from risk-assessment.ts 4-dimension scoring. Example: 75"
-                },
-                "risk_level": {
-                  "type": "string",
-                  "enum": [
-                    "low",
-                    "medium_low",
-                    "medium_high",
-                    "high"
-                  ],
-                  "description": "Risk level bucket. 'high' = strongly discourage purchase. Example: 'medium_high'"
-                },
-                "recommendations": {
-                  "type": "array",
-                  "items": {
-                    "type": "string"
+            "caller": {
+              "description": "The account (name/address) this guidance is framed for (env.account). Example: 'london_guide'",
+              "type": "string"
+            },
+            "options": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "next_node": {
+                    "type": "string",
+                    "description": "Target node this forward advances INTO. Example: 'serving'"
                   },
-                  "description": "Actionable recommendations for the buyer. Example: ['Require merchant to configure arbitration','Negotiate refund terms via Messenger']"
-                },
-                "reminders": {
-                  "type": "array",
-                  "items": {
+                  "forward": {
+                    "type": "string",
+                    "description": "Forward (operation) name. Example: 'StartService'"
+                  },
+                  "weight": {
+                    "type": "number",
+                    "description": "Forward weight contributed toward the pair threshold. Example: 1"
+                  },
+                  "operator": {
                     "type": "object",
                     "properties": {
-                      "id": {
-                        "type": "string",
-                        "description": "Reminder rule id. Example: 'high_risk_score'"
-                      },
-                      "stage": {
+                      "kind": {
                         "type": "string",
                         "enum": [
-                          "browse",
-                          "evaluate",
-                          "preorder",
-                          "in_progress",
-                          "complete",
-                          "after_sale"
+                          "order_holder",
+                          "permission_index",
+                          "named_operator"
                         ],
-                        "description": "Order lifecycle stage when this reminder fires. Example: 'evaluate'"
+                        "description": "Who can execute this forward (K3 feasibility). 'order_holder' = the Order owner (customer; forward namedOperator=''), 'permission_index' = a permission role, 'named_operator' = a specific Progress namespace operator."
                       },
-                      "priority": {
-                        "type": "string",
-                        "enum": [
-                          "required",
-                          "recommended",
-                          "info",
-                          "reminder"
-                        ],
-                        "description": "Priority. 'required' = blocks purchase; 'recommended' = strong caution. Example: 'required'"
+                      "permission_index": {
+                        "description": "Permission index when kind='permission_index'. Example: 1000",
+                        "type": "integer",
+                        "minimum": -9007199254740991,
+                        "maximum": 9007199254740991
                       },
-                      "message": {
-                        "type": "string",
-                        "description": "Human-readable reminder message. Example: 'Composite risk score 25/100, strongly discourage purchase'"
+                      "role_name": {
+                        "description": "Resolved role display name. Example: 'merchant (permission 1000)' / 'order holder (customer)'",
+                        "type": "string"
                       },
-                      "action": {
-                        "type": "string",
-                        "description": "Suggested next action. Example: 'require merchant to bind Arbitration before ordering'"
+                      "account_name": {
+                        "description": "Resolved local account/mark name when the operator maps to a concrete account. Example: 'london_guide'",
+                        "type": "string"
+                      },
+                      "named_operator": {
+                        "description": "NamedOperator namespace when kind='named_operator'. Example: 'delivery_team'",
+                        "type": "string"
                       }
                     },
                     "required": [
-                      "id",
-                      "stage",
-                      "priority",
-                      "message"
+                      "kind"
                     ],
                     "additionalProperties": false,
-                    "description": "A buyer-side reminder triggered at a specific order lifecycle stage (Phase 3 C-3)."
+                    "description": "Who can execute this forward (which account + which permission)."
                   },
-                  "description": "Stage-specific reminders (deduped, sorted by priority, capped to 3 high-risk). Example: [{priority:'required', message:'Ambiguous Guard must be human-reviewed'}]"
-                },
-                "preference_match": {
-                  "type": "object",
-                  "properties": {
-                    "score": {
-                      "type": "number",
-                      "minimum": 0,
-                      "maximum": 100,
-                      "description": "Match score 0-100 (higher = better fit). Example: 75"
-                    },
-                    "matches": {
-                      "type": "array",
-                      "items": {
-                        "type": "string"
-                      },
-                      "description": "Aspects that match user preferences. Example: ['Price 10% below average','Has arbitration']"
-                    },
-                    "mismatches": {
-                      "type": "array",
-                      "items": {
-                        "type": "string"
-                      },
-                      "description": "Aspects that mismatch user preferences. Example: ['Delivery cycle exceeds expectation']"
+                  "guard": {
+                    "description": "Guard bound to the forward — acceptance condition verified BEFORE the transition. Example: 'guard_payout'",
+                    "type": "string"
+                  },
+                  "business_meaning": {
+                    "type": "string",
+                    "description": "Business meaning of advancing to this node. Example: 'Guide starts the day service'"
+                  },
+                  "gains": {
+                    "description": "Gains for the caller if this option is chosen (K3 Game G1 收益分离). Example: ['Settlement triggered — funds released to provider']",
+                    "type": "array",
+                    "items": {
+                      "type": "string"
                     }
                   },
-                  "required": [
-                    "score",
-                    "matches",
-                    "mismatches"
-                  ],
-                  "additionalProperties": false,
-                  "description": "Service-to-preference match (populated when user preferences exist). Example: {score:75, matches:[...], mismatches:[...]}"
-                }
+                  "risks": {
+                    "description": "Risks for the caller if this option is chosen (K3 Game G1 风险分离). Example: ['Refund leverage lost after confirmation']",
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    }
+                  },
+                  "consistency": {
+                    "description": "Consistency 0-100 between this option's business semantics and the caller's interests (K3 Game optimality). Higher = more aligned.",
+                    "type": "number",
+                    "minimum": 0,
+                    "maximum": 100
+                  },
+                  "recommended": {
+                    "description": "Whether this is the recommended option (highest consistency).",
+                    "type": "boolean"
+                  }
+                },
+                "required": [
+                  "next_node",
+                  "forward",
+                  "weight",
+                  "operator",
+                  "business_meaning"
+                ],
+                "additionalProperties": false,
+                "description": "A reachable next-node option with its operator/permission, guard, business meaning, and K3-style gains/risks/consistency."
               },
-              "required": [
-                "recommendations",
-                "reminders"
-              ],
-              "additionalProperties": false,
-              "description": "Buyer-side advice (Phase 3 C-3.3). Populated when customer_intelligence service is enabled AND operation is order/query on a Service. Contains risk_score, recommendations, reminders, and preference_match."
+              "description": "ALL reachable next-node directions (every operator/permission/guard disclosed)."
             },
-            "evolution_context": {
+            "recommendation": {
+              "description": "Recommended option with rationale (K3 Game 意图/博弈/利益).",
               "type": "object",
               "properties": {
-                "industry_signal": {
-                  "type": "string",
-                  "description": "Industry evolution signal summary. Example: 'Industry health 82/100 (healthy); 25 cumulative industry signals'"
-                },
-                "evolution_advice": {
-                  "type": "string",
-                  "description": "Evolution advice for the current operation. Example: 'Recommend mandatory arbitration + compensation fund + delivery Guard'"
-                },
-                "confidence": {
-                  "type": "number",
-                  "minimum": 0,
-                  "maximum": 1,
-                  "description": "Confidence of the evolution context 0-1. <0.5 means no data yet. Example: 0.75"
-                },
-                "health_score": {
-                  "type": "number",
-                  "minimum": 0,
-                  "maximum": 100,
-                  "description": "Industry health score 0-100 if available. Example: 82"
-                },
-                "pending_suggestions": {
-                  "type": "integer",
-                  "minimum": 0,
-                  "description": "Count of pending industry update suggestions (filtered by role if role is set). Example: 3"
-                },
-                "intent": {
-                  "type": "string",
-                  "enum": [
-                    "default",
-                    "growth",
-                    "retention",
-                    "compliance",
-                    "efficiency",
-                    "trust_building",
-                    "custom"
-                  ],
-                  "description": "Phase 4 P4-6.C: Current business intent driving the scoring model. Absent = 'default'. Example: 'growth'"
+                "best": {
+                  "description": "Recommended action in '<forward> → <next_node>' form. Example: 'StartService → serving'",
+                  "type": "string"
                 },
-                "role_advice": {
-                  "type": "array",
-                  "items": {
-                    "type": "string"
-                  },
-                  "description": "Phase 4 P4-6.C: Role-targeted advice strings (merchant/customer/prospect/supplier/collaborator/arbitrator). Example: ['Strengthen loyalty flywheel','Optimize first-order conversion']"
+                "rationale": {
+                  "description": "Why this option is recommended (framed at the caller's value: gains/risks). Example: 'For the guide, advancing to serving triggers the delivery flow'",
+                  "type": "string"
                 },
-                "role": {
-                  "type": "string",
-                  "enum": [
-                    "merchant",
-                    "customer",
-                    "prospect",
-                    "supplier",
-                    "collaborator",
-                    "arbitrator"
-                  ],
-                  "description": "Phase 4 P4-6.C: Role used for advice routing. Example: 'merchant'"
+                "caveat": {
+                  "description": "Disclosed trade-off / opportunity cost of NOT taking another path (K3 Game G3 机会成本). Example: 'Choosing cancelled forfeits this order's settlement'",
+                  "type": "string"
                 }
               },
-              "required": [
-                "confidence"
-              ],
-              "additionalProperties": false,
-              "description": "Phase 4 industry evolution context (populated when industry_evolution service is enabled). Provides AI with industry health signals and evolution advice."
+              "additionalProperties": false
             },
-            "guard_advice": {
-              "type": "object",
-              "properties": {
-                "current_round": {
-                  "type": "string",
-                  "enum": [
-                    "R1",
-                    "R2",
-                    "R3",
-                    "R4",
-                    "R5",
-                    "R6",
-                    "R7",
-                    "R8",
-                    "R9",
-                    "R10"
-                  ],
-                  "description": "Current R1-R10 dialogue round. R1=intent, R2=table, R3=tree, R4=rely, R5=binding, R6=review, R7=CREATE, R8=test, R9=bind, R10=verify. Example: 'R3'"
-                },
-                "puzzle_status": {
-                  "type": "object",
-                  "properties": {
-                    "intent": {
-                      "type": "boolean",
-                      "description": "Intent dimension complete (action + rule + failure conditions)"
-                    },
-                    "binding": {
-                      "type": "boolean",
-                      "description": "Binding dimension complete (host object + field + circular ref)"
-                    },
-                    "data": {
-                      "type": "boolean",
-                      "description": "Data dimension complete (table entries + witnesses)"
-                    },
-                    "query": {
-                      "type": "boolean",
-                      "description": "Query dimension complete (query instructions if needed)"
-                    },
-                    "logic": {
-                      "type": "boolean",
-                      "description": "Logic dimension complete (root node returns Bool)"
-                    },
-                    "constraints": {
-                      "type": "boolean",
-                      "description": "Constraints dimension complete (10 Pitfalls checked)"
-                    }
+            "note": {
+              "description": "Additional note (e.g. wait for the other party, entry/terminal hint).",
+              "type": "string"
+            }
+          },
+          "required": [
+            "current_node",
+            "options"
+          ],
+          "additionalProperties": false
+        },
+        "workflow_receipt": {
+          "description": "K3 operate receipt: which account did what, whether the node migrated, and threshold/weight cooperation status when it did not. AI must relay this to the user after every progress operation.",
+          "type": "object",
+          "properties": {
+            "account": {
+              "type": "string",
+              "description": "The account that executed the operation (env.account). Example: 'london_guide'"
+            },
+            "action": {
+              "type": "string",
+              "description": "What was done. Example: 'london_guide executed StartService (paid → serving)'"
+            },
+            "forward": {
+              "type": "string",
+              "description": "Forward name executed. Example: 'StartService'"
+            },
+            "target_node": {
+              "type": "string",
+              "description": "Target node of the executed forward. Example: 'serving'"
+            },
+            "op": {
+              "description": "Operation type executed.",
+              "type": "string",
+              "enum": [
+                "next",
+                "hold",
+                "unhold",
+                "adminUnhold"
+              ]
+            },
+            "migrated": {
+              "type": "boolean",
+              "description": "Whether the Progress migrated to the target node (true) or stayed (false — weights still accumulating toward threshold)."
+            },
+            "current_node": {
+              "type": "string",
+              "description": "Progress.current after the operation."
+            },
+            "threshold": {
+              "description": "Pair threshold when NOT migrated (threshold > 0).",
+              "type": "number"
+            },
+            "accumulated_weight": {
+              "description": "Accumulated forward weight in the current session when NOT migrated.",
+              "type": "number"
+            },
+            "remaining": {
+              "description": "threshold - accumulated_weight when NOT migrated.",
+              "type": "number"
+            },
+            "waiting_on": {
+              "description": "Pending forwards + their operators when NOT migrated (K3 Game G4 — who must cooperate next).",
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "forward": {
+                    "type": "string",
+                    "description": "Forward still required to reach the threshold. Example: 'GuideConfirm'"
                   },
-                  "required": [
-                    "intent",
-                    "binding",
-                    "data",
-                    "query",
-                    "logic",
-                    "constraints"
-                  ],
-                  "additionalProperties": false,
-                  "description": "Information puzzle completeness (6 dimensions). Missing dimensions need user input before CREATE."
-                },
-                "matched_scene": {
-                  "type": "string",
-                  "description": "Matched Guard scene id from the 8 binding scenarios ledger. Example: 'machine_forward_guard'"
+                  "operator": {
+                    "type": "object",
+                    "properties": {
+                      "kind": {
+                        "type": "string",
+                        "enum": [
+                          "order_holder",
+                          "permission_index",
+                          "named_operator"
+                        ],
+                        "description": "Who can execute this forward (K3 feasibility). 'order_holder' = the Order owner (customer; forward namedOperator=''), 'permission_index' = a permission role, 'named_operator' = a specific Progress namespace operator."
+                      },
+                      "permission_index": {
+                        "description": "Permission index when kind='permission_index'. Example: 1000",
+                        "type": "integer",
+                        "minimum": -9007199254740991,
+                        "maximum": 9007199254740991
+                      },
+                      "role_name": {
+                        "description": "Resolved role display name. Example: 'merchant (permission 1000)' / 'order holder (customer)'",
+                        "type": "string"
+                      },
+                      "account_name": {
+                        "description": "Resolved local account/mark name when the operator maps to a concrete account. Example: 'london_guide'",
+                        "type": "string"
+                      },
+                      "named_operator": {
+                        "description": "NamedOperator namespace when kind='named_operator'. Example: 'delivery_team'",
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "kind"
+                    ],
+                    "additionalProperties": false,
+                    "description": "Who must execute this forward next."
+                  }
                 },
-                "scene_description": {
+                "required": [
+                  "forward",
+                  "operator"
+                ],
+                "additionalProperties": false,
+                "description": "A forward still pending — who must act next (threshold cooperation, K3 Game G4 阈值配合)."
+              }
+            },
+            "next_guidance": {
+              "description": "Next-node guidance from the resulting current node.",
+              "type": "object",
+              "properties": {
+                "current_node": {
                   "type": "string",
-                  "description": "Human-readable scene description. Example: 'Workflow node forward validation (Forward.guard)'"
-                },
-                "scene_constraints": {
-                  "type": "array",
-                  "items": {
-                    "type": "string"
-                  },
-                  "description": "Special constraints for the matched scene. Example: ['Forward.guard cannot be modified after Machine is published']"
+                  "description": "Current node of the Progress. Example: 'serving'"
                 },
-                "suggested_patterns": {
-                  "type": "array",
-                  "items": {
-                    "type": "string"
-                  },
-                  "description": "Suggested Guard patterns based on user intent. Example: ['time lock','progress status check']"
+                "caller": {
+                  "description": "The account (name/address) this guidance is framed for (env.account). Example: 'london_guide'",
+                  "type": "string"
                 },
-                "available_queries": {
+                "options": {
                   "type": "array",
                   "items": {
                     "type": "object",
                     "properties": {
-                      "id": {
-                        "type": "integer",
-                        "description": "Query instruction ID. Example: 1253"
-                      },
-                      "name": {
+                      "next_node": {
                         "type": "string",
-                        "description": "Query instruction name. Example: 'progress.current'"
+                        "description": "Target node this forward advances INTO. Example: 'serving'"
                       },
-                      "objectType": {
+                      "forward": {
                         "type": "string",
-                        "description": "Target object type. Example: 'Progress'"
+                        "description": "Forward (operation) name. Example: 'StartService'"
                       },
-                      "returnType": {
-                        "type": "string",
-                        "description": "Return value type. Example: 'String'"
+                      "weight": {
+                        "type": "number",
+                        "description": "Forward weight contributed toward the pair threshold. Example: 1"
                       },
-                      "description": {
+                      "operator": {
+                        "type": "object",
+                        "properties": {
+                          "kind": {
+                            "type": "string",
+                            "enum": [
+                              "order_holder",
+                              "permission_index",
+                              "named_operator"
+                            ],
+                            "description": "Who can execute this forward (K3 feasibility). 'order_holder' = the Order owner (customer; forward namedOperator=''), 'permission_index' = a permission role, 'named_operator' = a specific Progress namespace operator."
+                          },
+                          "permission_index": {
+                            "description": "Permission index when kind='permission_index'. Example: 1000",
+                            "type": "integer",
+                            "minimum": -9007199254740991,
+                            "maximum": 9007199254740991
+                          },
+                          "role_name": {
+                            "description": "Resolved role display name. Example: 'merchant (permission 1000)' / 'order holder (customer)'",
+                            "type": "string"
+                          },
+                          "account_name": {
+                            "description": "Resolved local account/mark name when the operator maps to a concrete account. Example: 'london_guide'",
+                            "type": "string"
+                          },
+                          "named_operator": {
+                            "description": "NamedOperator namespace when kind='named_operator'. Example: 'delivery_team'",
+                            "type": "string"
+                          }
+                        },
+                        "required": [
+                          "kind"
+                        ],
+                        "additionalProperties": false,
+                        "description": "Who can execute this forward (which account + which permission)."
+                      },
+                      "guard": {
+                        "description": "Guard bound to the forward — acceptance condition verified BEFORE the transition. Example: 'guard_payout'",
+                        "type": "string"
+                      },
+                      "business_meaning": {
                         "type": "string",
-                        "description": "Query description"
+                        "description": "Business meaning of advancing to this node. Example: 'Guide starts the day service'"
+                      },
+                      "gains": {
+                        "description": "Gains for the caller if this option is chosen (K3 Game G1 收益分离). Example: ['Settlement triggered — funds released to provider']",
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        }
+                      },
+                      "risks": {
+                        "description": "Risks for the caller if this option is chosen (K3 Game G1 风险分离). Example: ['Refund leverage lost after confirmation']",
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        }
+                      },
+                      "consistency": {
+                        "description": "Consistency 0-100 between this option's business semantics and the caller's interests (K3 Game optimality). Higher = more aligned.",
+                        "type": "number",
+                        "minimum": 0,
+                        "maximum": 100
+                      },
+                      "recommended": {
+                        "description": "Whether this is the recommended option (highest consistency).",
+                        "type": "boolean"
                       }
                     },
                     "required": [
-                      "id",
-                      "name",
-                      "objectType",
-                      "returnType"
+                      "next_node",
+                      "forward",
+                      "weight",
+                      "operator",
+                      "business_meaning"
                     ],
                     "additionalProperties": false,
-                    "description": "A Guard query instruction available for the current context (subset of GUARDQUERY 375 entries)."
-                  },
-                  "description": "Available query instructions for the current context (subset of 375 GUARDQUERY entries)"
-                },
-                "risk_warnings": {
-                  "type": "array",
-                  "items": {
-                    "type": "string"
+                    "description": "A reachable next-node option with its operator/permission, guard, business meaning, and K3-style gains/risks/consistency."
                   },
-                  "description": "Risk warnings for the current Guard design. Example: ['Guard cannot be modified after creation','Time lock test uses 1000ms']"
+                  "description": "ALL reachable next-node directions (every operator/permission/guard disclosed)."
                 },
-                "pending_questions": {
-                  "type": "array",
-                  "items": {
-                    "type": "string"
-                  },
-                  "description": "Questions for the user to complete the puzzle. Example: ['Which Host Object will the Guard bind to?']"
-                },
-                "confirmation_text": {
-                  "type": "string",
-                  "description": "Structured semantic confirmation text for user review (generated when puzzle is complete). User must explicitly confirm before CREATE."
-                },
-                "test_result": {
+                "recommendation": {
+                  "description": "Recommended option with rationale (K3 Game 意图/博弈/利益).",
                   "type": "object",
                   "properties": {
-                    "status": {
-                      "type": "string",
-                      "enum": [
-                        "pass",
-                        "fail",
-                        "not_tested"
-                      ]
+                    "best": {
+                      "description": "Recommended action in '<forward> → <next_node>' form. Example: 'StartService → serving'",
+                      "type": "string"
                     },
-                    "failure_node": {
-                      "type": "string",
-                      "description": "Node that caused failure (if fail)"
+                    "rationale": {
+                      "description": "Why this option is recommended (framed at the caller's value: gains/risks). Example: 'For the guide, advancing to serving triggers the delivery flow'",
+                      "type": "string"
                     },
-                    "passport_id": {
-                      "type": "string",
-                      "description": "Generated Passport ID (if pass)"
+                    "caveat": {
+                      "description": "Disclosed trade-off / opportunity cost of NOT taking another path (K3 Game G3 机会成本). Example: 'Choosing cancelled forfeits this order's settlement'",
+                      "type": "string"
                     }
                   },
-                  "required": [
-                    "status"
-                  ],
-                  "additionalProperties": false,
-                  "description": "gen_passport static test result. Must pass before CREATE."
+                  "additionalProperties": false
                 },
-                "risk_assessment": {
-                  "type": "object",
-                  "properties": {
-                    "overall_risk": {
-                      "type": "string",
-                      "enum": [
-                        "critical",
-                        "high",
-                        "medium",
-                        "low",
-                        "info"
-                      ],
-                      "description": "Overall risk level (highest from all risks)"
-                    },
-                    "risk_count": {
-                      "type": "integer",
-                      "description": "Total number of detected risks"
-                    },
-                    "critical_count": {
-                      "type": "integer",
-                      "description": "Number of critical risks"
-                    },
-                    "high_count": {
-                      "type": "integer",
-                      "description": "Number of high risks"
-                    },
-                    "needs_human_review": {
-                      "type": "boolean",
-                      "description": "Whether human review is required (critical or 2+ high risks)"
-                    },
-                    "top_risks": {
-                      "type": "array",
-                      "items": {
-                        "type": "string"
-                      },
-                      "description": "Top risk titles (critical and high, max 3)"
-                    },
-                    "stakeholder_advice": {
-                      "type": "object",
-                      "additionalProperties": {
-                        "type": "array",
-                        "items": {
-                          "type": "string"
-                        }
-                      },
-                      "description": "Per-stakeholder advice. Key=stakeholder (customer/provider/arbitrator/claimant), value=advice list"
-                    }
-                  },
-                  "required": [
-                    "overall_risk",
-                    "risk_count",
-                    "critical_count",
-                    "high_count",
-                    "needs_human_review",
-                    "top_risks"
-                  ],
-                  "additionalProperties": false,
-                  "description": "Business-layer risk assessment (game theory, data source trust, logic gaps). Populated during Guard design to warn about business risks beyond syntax."
+                "note": {
+                  "description": "Additional note (e.g. wait for the other party, entry/terminal hint).",
+                  "type": "string"
                 }
               },
-              "additionalProperties": false,
-              "description": "Phase 5 Guard capability advice (populated when user intent involves Guard). Provides puzzle status, scene matching, suggested patterns, available queries, risk warnings, and confirmation text. AI uses this to guide Guard design dialogue (R1-R10)."
+              "required": [
+                "current_node",
+                "options"
+              ],
+              "additionalProperties": false
+            },
+            "note": {
+              "description": "Additional note.",
+              "type": "string"
             }
           },
           "required": [
-            "intent",
-            "status",
-            "summary"
+            "account",
+            "action",
+            "forward",
+            "target_node",
+            "migrated",
+            "current_node"
           ],
-          "additionalProperties": false,
-          "description": "Business semantic summary for local mark operation"
+          "additionalProperties": false
         }
       },
       "required": [
-        "result"
+        "intent",
+        "status",
+        "summary"
       ],
-      "additionalProperties": false,
-      "description": "Local mark operation output wrapped schema"
+      "additionalProperties": false
     }
-  }
+  },
+  "required": [
+    "result"
+  ],
+  "additionalProperties": false
 }