@wowok/agent-mcp 2.5.4 → 2.6.0

package/dist/schemas/project_operation.schema.json

@@ -1,8 +1,8 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://wowok.net/schemas/project_operation.json",
-  "title": "Project - Namespace & Object Graph",
-  "description": "Manage and query the local object dependency graph (DAG) built on top of local_mark tags. Actions: list_projects, list_objects, shareable, dependencies, referenced_by, pre_publish_check, cross_project_refs, graph_stats, save_graph, load_graph.",
+  "title": "Project - Entity Management & Evaluation",
+  "description": "Project management service — manage projects as first-class entities with SQLite persistence, rigid project-object relationships, three-pathway graph construction, and a dual rule-based + LLM-assisted evaluation engine. Actions: list_projects, create_project, create_project_from_onchain, update_project, get_project_detail, add_object, remove_object, create_version, build_graph, get_graph, evaluate_project, save_evaluation, compare_projects, refresh_objects, get_object_diff, assemble_context.",
   "$ref": "#/definitions/project_operation",
   "definitions": {
     "project_operation": {
@@ -12,68 +12,94 @@
           "type": "string",
           "enum": [
             "list_projects",
-            "list_objects",
-            "shareable",
-            "dependencies",
-            "referenced_by",
-            "pre_publish_check",
-            "cross_project_refs",
-            "graph_stats",
-            "save_graph",
-            "load_graph",
-            "analyze_intent",
-            "aggregate_risks",
-            "generate_deployment_doc",
-            "trace_substeps",
-            "get_project_status",
-            "load_project",
-            "fork_project",
-            "export_project",
-            "get_project_files",
-            "validate_stage_unit",
-            "get_stage_assessment",
-            "get_stage_risk_policy",
-            "get_doc_relations",
-            "update_deployment_doc",
-            "validate_validation_chain",
-            "apply_improvement",
-            "get_improvement_queue",
-            "get_flywheel_config",
-            "rollback_stage",
-            "get_reversibility",
-            "assemble_context"
+            "create_project",
+            "create_project_from_onchain",
+            "update_project",
+            "get_project_detail",
+            "add_object",
+            "remove_object",
+            "update_object",
+            "create_version",
+            "build_graph",
+            "get_graph",
+            "evaluate_project",
+            "save_evaluation",
+            "compare_projects",
+            "refresh_objects",
+            "get_object_diff",
+            "delete_project",
+            "assemble_context",
+            "generate_deployment_doc"
           ],
-          "description": "Action to perform. Six categories:\n1. Graph Query (10): list_projects, list_objects, shareable, dependencies, referenced_by, pre_publish_check, cross_project_refs, graph_stats, save_graph, load_graph.\n2. Project-Based Deployment 5-Stage (4): Call IN ORDER — analyze_intent (Stage 2) → aggregate_risks (Stage 3) → generate_deployment_doc (Stage 4) → trace_substeps (Stage 5). Each action's output includes `next_action` telling you which action to call next. Stage 1 (Project Naming) uses the `project` + `version` params.\n3. Project Memory Layer (5): load_project, fork_project, export_project, get_project_files, get_project_status.\n4. Nested-Autonomy Stage Unit (6): validate_stage_unit, get_stage_assessment, get_stage_risk_policy, get_doc_relations, update_deployment_doc, validate_validation_chain.\n5. Distillation Reflow (3): apply_improvement (review + apply a proposal — config_override writes overrides/, source_patch writes patches/), get_improvement_queue (list pending/approved proposals), get_flywheel_config (query reflow loop status).\n6. Rollback & Reversibility (2): rollback_stage (evaluate + execute stage rollback with file cleanup — blocked if has_published_object), get_reversibility (query object lifecycle reversibility matrix for risk reminders).\n7. Context Assembly (1): assemble_context (query on-chain object states + extract embedded history + optional events, and assemble a structured semantic context for LLM consumption — bridges raw facts to business-understandable context). Required input: context_objects (array of object IDs/names). Optional: include_events (query recent state-transition events)."
+          "description": "Action to perform. Two categories:\n1. Project Entity + Evaluation (15, GLM6): list_projects, create_project, create_project_from_onchain, update_project, get_project_detail, add_object, remove_object, create_version, build_graph, get_graph, evaluate_project, save_evaluation, compare_projects, refresh_objects, get_object_diff. Projects are first-class entities with SQLite persistence, rigid project-object relationships, three-pathway graph construction, and a dual rule-based + LLM-assisted evaluation engine.\n2. Context Assembly (1): assemble_context (query on-chain object states + extract embedded history + optional events, and assemble a structured semantic context for LLM consumption). Required input: context_objects (array of object IDs/names). Optional: include_events (query recent state-transition events)."
         },
         "project": {
           "type": "string",
-          "description": "Project prefix (for list_objects and C1-C4 actions)"
+          "description": "Project prefix (human-readable unique identifier). Used by create_version, build_graph, evaluate_project, etc. Takes precedence resolution: project_id > project (prefix)."
         },
         "version": {
           "type": "string",
           "pattern": "^v\\d+$",
-          "description": "Project version (e.g. 'v1'). Required for C1-C4 actions."
+          "description": "Project version (e.g. 'v1'). Used by create_version."
         },
-        "object": {
+        "context_objects": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Object IDs (0x...) or LocalMark names to assemble context for. Required when action='assemble_context'. The current on-chain state of each object will be queried and enriched with semantic annotations."
+        },
+        "include_events": {
+          "type": "boolean",
+          "description": "When true, assemble_context also queries recent state-transition events (NewOrderEvent, ProgressEvent, ArbEvent, etc.). Events are the real-time transition log — convergent and bounded. Defaults to false. Note: object-embedded history (ProgressSession.forwards, Order.disputes) is ALWAYS extracted automatically — no flag needed."
+        },
+        "context_network": {
+          "type": "string",
+          "enum": [
+            "testnet",
+            "mainnet"
+          ],
+          "description": "Network for assemble_context queries. Defaults to 'testnet' if omitted."
+        },
+        "filter_status": {
           "type": "string",
-          "description": "Object name or address (for dependencies / referenced_by / pre_publish_check)"
+          "enum": [
+            "draft",
+            "active",
+            "inactive",
+            "archived"
+          ],
+          "description": "Filter list_projects by project status."
         },
-        "fork_to_version": {
+        "filter_perspective": {
           "type": "string",
-          "pattern": "^v\\d+$",
-          "description": "Target version for fork_project (e.g. 'v2'). Must differ from source 'version'."
+          "enum": [
+            "producer",
+            "consumer",
+            "both"
+          ],
+          "description": "Filter list_projects by project perspective."
         },
-        "fork_to_prefix": {
+        "filter_network": {
           "type": "string",
-          "description": "Target prefix for fork_project. Defaults to source 'project' prefix when omitted."
+          "enum": [
+            "testnet",
+            "mainnet"
+          ],
+          "description": "Filter list_projects by network."
         },
-        "user_intent": {
+        "project_name": {
           "type": "string",
           "minLength": 1,
+          "maxLength": 200,
+          "description": "Display name for create_project / create_project_from_onchain / update_project. Required when action='create_project'."
+        },
+        "project_description": {
+          "type": "string",
           "maxLength": 2000,
-          "description": "Natural-language business intent for analyze_intent (stage 2). Required when action='analyze_intent'."
+          "description": "Project description for create_project / update_project."
         },
-        "industry": {
+        "project_industry": {
           "type": "string",
           "enum": [
             "general",
@@ -86,553 +112,213 @@
             "subscription",
             "custom"
           ],
-          "description": "Industry hint — drives template defaults. Used by analyze_intent and aggregate_risks."
+          "description": "Industry tag for create_project. Drives template defaults."
         },
-        "target_objects": {
-          "type": "array",
-          "items": {
-            "type": "string"
-          },
-          "description": "Optional explicit target objects (entry_ids or object_type names) for analyze_intent."
-        },
-        "puzzles": {
-          "type": "object",
-          "additionalProperties": {
-            "type": "object",
-            "properties": {
-              "puzzle": {
-                "type": "object",
-                "additionalProperties": {},
-                "description": "Per-object puzzle snapshot. Shape varies per object_type — see knowledge/<obj>-puzzle.ts."
-              },
-              "completeness": {
-                "type": "object",
-                "additionalProperties": {},
-                "description": "Completeness assessment from checkPuzzleCompleteness(). Shape varies per object."
-              },
-              "missing_dimensions": {
-                "type": "array",
-                "items": {
-                  "type": "string"
-                },
-                "description": "Dimensions still missing for this object (e.g. ['A','B'])."
-              }
-            },
-            "required": [
-              "puzzle",
-              "completeness",
-              "missing_dimensions"
-            ],
-            "additionalProperties": false
-          },
-          "description": "Per-object puzzle snapshots keyed by object_type. Required for aggregate_risks and generate_deployment_doc."
-        },
-        "severity_threshold": {
+        "project_perspective": {
           "type": "string",
           "enum": [
-            "CRITICAL",
-            "HIGH",
-            "MEDIUM",
-            "LOW",
-            "INFO"
+            "producer",
+            "consumer",
+            "both"
           ],
-          "description": "Severity threshold for aggregate_risks. Risks at or above this level are flagged."
+          "description": "Project perspective for create_project. 'producer' = build/operate services, 'consumer' = evaluate/buy services, 'both' = dual role. Defaults to 'producer'."
         },
-        "user_confirmed_high_risks": {
+        "project_labels": {
           "type": "array",
           "items": {
             "type": "string"
           },
-          "description": "IDs of HIGH risks the user has already confirmed (suppressed in subsequent aggregate_risks)."
+          "description": "Free-form labels for create_project / update_project (e.g. ['travel','london','priority'])."
         },
-        "business_intent": {
+        "service_address": {
           "type": "string",
-          "minLength": 1,
-          "maxLength": 500,
-          "description": "One-line business intent description for the deployment doc. Required when action='generate_deployment_doc'."
+          "description": "On-chain Service object address. Required for create_project_from_onchain. Optional for create_project (links the project to its core Service)."
         },
-        "author": {
+        "project_network": {
           "type": "string",
-          "description": "Optional author name for the deployment doc meta section."
-        },
-        "objects": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "properties": {
-              "entry_id": {
-                "type": "string",
-                "description": "Stable id '<object_type>:<name>'"
-              },
-              "object_type": {
-                "type": "string",
-                "enum": [
-                  "service",
-                  "machine",
-                  "guard",
-                  "permission",
-                  "reward",
-                  "arb",
-                  "progress",
-                  "treasury",
-                  "demand",
-                  "repository",
-                  "contact",
-                  "order",
-                  "allocation",
-                  "personal",
-                  "payment",
-                  "proof"
-                ]
-              },
-              "name": {
-                "type": "string"
-              },
-              "reused_from": {
-                "type": "string",
-                "description": "Existing on-chain address or local name if reused"
-              },
-              "publish_required": {
-                "type": "boolean",
-                "description": "Whether publish is required (only Service/Machine)"
-              },
-              "description": {
-                "type": "string"
-              }
-            },
-            "required": [
-              "entry_id",
-              "object_type",
-              "name",
-              "publish_required"
-            ],
-            "additionalProperties": false
-          },
-          "description": "Deployment objects for generate_deployment_doc."
-        },
-        "edges": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "properties": {
-              "from": {
-                "type": "string"
-              },
-              "to": {
-                "type": "string"
-              },
-              "edge_kind": {
-                "type": "string",
-                "enum": [
-                  "machine",
-                  "order_allocators",
-                  "arbitrations",
-                  "compensation_fund",
-                  "rewards",
-                  "buy_guard",
-                  "permission",
-                  "guard",
-                  "prev",
-                  "next",
-                  "forward",
-                  "parent",
-                  "service",
-                  "progress",
-                  "arbitration",
-                  "sub_order",
-                  "references"
-                ]
-              },
-              "field_path": {
-                "type": "string"
-              },
-              "required_at_publish": {
-                "type": "boolean"
-              }
-            },
-            "required": [
-              "from",
-              "to",
-              "edge_kind",
-              "field_path",
-              "required_at_publish"
-            ],
-            "additionalProperties": false
-          },
-          "description": "Dependency graph edges for generate_deployment_doc."
-        },
-        "steps": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "properties": {
-              "step": {
-                "type": "integer",
-                "exclusiveMinimum": 0
-              },
-              "object_type": {
-                "$ref": "#/definitions/project_operation/properties/objects/items/properties/object_type"
-              },
-              "operation": {
-                "type": "string"
-              },
-              "substep_count": {
-                "type": "integer",
-                "minimum": 0
-              },
-              "depends_on": {
-                "type": "array",
-                "items": {
-                  "type": "integer"
-                }
-              },
-              "entry_id": {
-                "type": "string"
-              },
-              "network_phase": {
-                "type": "string",
-                "enum": [
-                  "testnet",
-                  "mainnet",
-                  "both"
-                ]
-              }
-            },
-            "required": [
-              "step",
-              "object_type",
-              "operation",
-              "substep_count",
-              "depends_on",
-              "entry_id",
-              "network_phase"
-            ],
-            "additionalProperties": false
-          },
-          "description": "Topological execution plan for generate_deployment_doc."
+          "enum": [
+            "testnet",
+            "mainnet"
+          ],
+          "description": "Network the project is bound to. A Service deployed to different networks are different projects. Defaults to 'testnet'."
         },
-        "scenarios": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "properties": {
-              "scenario_id": {
-                "type": "string"
-              },
-              "description": {
-                "type": "string"
-              },
-              "primary_object": {
-                "type": "string"
-              },
-              "supporting_objects": {
-                "type": "array",
-                "items": {
-                  "type": "string"
-                }
-              },
-              "test_step_refs": {
-                "type": "array",
-                "items": {
-                  "type": "string"
-                }
-              }
-            },
-            "required": [
-              "scenario_id",
-              "description",
-              "primary_object",
-              "supporting_objects"
-            ],
-            "additionalProperties": false
-          },
-          "description": "Business scenarios for generate_deployment_doc §7."
+        "project_id": {
+          "type": "string",
+          "description": "Project UUID for update_project / get_project_detail / add_object / remove_object / create_version / build_graph / evaluate_project / refresh_objects. Takes precedence over 'project' (prefix) when both are given."
         },
-        "risk_status": {
+        "project_status": {
           "type": "string",
           "enum": [
-            "RISK_PASSED",
-            "RISK_BLOCKED",
-            "RISK_PENDING_CONFIRM",
-            "RISK_CANCELLED"
+            "draft",
+            "active",
+            "inactive",
+            "archived"
           ],
-          "description": "Risk status from aggregate_risks (for D-16 check)."
+          "description": "New status for update_project. 'active' projects are live, 'archived' are read-only."
         },
-        "risk_critical_count": {
-          "type": "integer",
-          "minimum": 0,
-          "description": "CRITICAL risk count from aggregate_risks."
-        },
-        "risk_high_count": {
-          "type": "integer",
-          "minimum": 0,
-          "description": "HIGH risk count from aggregate_risks."
+        "object_address": {
+          "type": "string",
+          "description": "On-chain object address (0x...) for add_object / remove_object. For add_object, alternatively use object_name to resolve via LocalMark."
         },
-        "run_scanner": {
-          "type": "boolean",
-          "description": "Whether to run deployment-scanner validation after generating the doc. Defaults to true."
+        "object_name_add": {
+          "type": "string",
+          "description": "LocalMark name for add_object (alternative to object_address)."
         },
-        "gas_budget": {
-          "type": "object",
-          "properties": {
-            "network": {
-              "type": "string",
-              "enum": [
-                "testnet",
-                "mainnet"
-              ]
-            },
-            "already_spent_gas": {
-              "type": "integer",
-              "minimum": 0,
-              "description": "Gas already spent on-chain in MIST (from telemetry). Defaults to 0."
-            },
-            "estimated_rerun_gas": {
-              "type": "integer",
-              "minimum": 0,
-              "description": "Estimated gas to re-run remaining ops in MIST. Auto-computed from estimateDeploymentGas when omitted."
-            },
-            "warning": {
-              "type": "string",
-              "description": "Custom warning text. Defaults to a computed cost summary."
-            }
-          },
-          "required": [
-            "network"
+        "object_type_add": {
+          "type": "string",
+          "enum": [
+            "Service",
+            "Machine",
+            "Guard",
+            "Permission",
+            "Reward",
+            "Arbitration",
+            "Progress",
+            "Treasury",
+            "Demand",
+            "Repository",
+            "Contact",
+            "Order",
+            "Allocation",
+            "Personal",
+            "Payment",
+            "Proof"
           ],
-          "additionalProperties": false,
-          "description": "Gas budget input for stage 4/5 gate (§3.5). Non-blocking; only surfaces a WARN on mainnet."
+          "description": "Object type for add_object."
         },
-        "network": {
+        "object_role": {
           "type": "string",
           "enum": [
-            "testnet",
-            "mainnet"
+            "core",
+            "dependency",
+            "reference"
           ],
-          "description": "Target network for trace_substeps."
+          "description": "Object role in project for add_object. 'core' = the Service (only one per project), 'dependency' = required binding, 'reference' = optional/auxiliary. Defaults to 'reference'."
         },
-        "substeps": {
+        "object_tags_add": {
           "type": "array",
           "items": {
-            "type": "object",
-            "properties": {
-              "step_id": {
-                "type": "string",
-                "pattern": "^T\\d+\\.\\d+$"
-              },
-              "parent_step": {
-                "type": "string",
-                "pattern": "^T\\d+$"
-              },
-              "object_type": {
-                "$ref": "#/definitions/project_operation/properties/objects/items/properties/object_type"
-              },
-              "entry_id": {
-                "type": "string"
-              },
-              "operation_type": {
-                "type": "string"
-              },
-              "network": {
-                "type": "string",
-                "enum": [
-                  "testnet",
-                  "mainnet"
-                ]
-              },
-              "input": {
-                "type": "object",
-                "properties": {
-                  "data": {
-                    "type": "object",
-                    "additionalProperties": {}
-                  },
-                  "input_refs": {
-                    "type": "array",
-                    "items": {
-                      "type": "string"
-                    }
-                  }
-                },
-                "required": [
-                  "data",
-                  "input_refs"
-                ],
-                "additionalProperties": false
-              },
-              "output": {
-                "type": "object",
-                "properties": {
-                  "object_id": {
-                    "type": "string"
-                  },
-                  "tx_digest": {
-                    "type": "string"
-                  }
-                },
-                "additionalProperties": false
-              },
-              "timestamp": {
-                "type": "integer"
-              },
-              "status": {
-                "type": "string",
-                "enum": [
-                  "PENDING",
-                  "SUCCESS",
-                  "FAILED",
-                  "SKIPPED"
-                ]
-              },
-              "failure_reason": {
-                "type": "string"
-              },
-              "dependencies": {
-                "type": "object",
-                "properties": {
-                  "input_refs": {
-                    "type": "array",
-                    "items": {
-                      "type": "string"
-                    }
-                  },
-                  "output_refs": {
-                    "type": "array",
-                    "items": {
-                      "type": "object",
-                      "properties": {
-                        "substep_id": {
-                          "type": "string"
-                        },
-                        "field_path": {
-                          "type": "string"
-                        }
-                      },
-                      "required": [
-                        "substep_id",
-                        "field_path"
-                      ],
-                      "additionalProperties": false
-                    }
-                  }
-                },
-                "required": [
-                  "input_refs",
-                  "output_refs"
-                ],
-                "additionalProperties": false
-              },
-              "retry_info": {
-                "type": "object",
-                "properties": {
-                  "original_step_id": {
-                    "type": "string"
-                  },
-                  "retry_count": {
-                    "type": "integer",
-                    "minimum": 0
-                  },
-                  "retry_reason": {
-                    "type": "string"
-                  }
-                },
-                "required": [
-                  "original_step_id",
-                  "retry_count",
-                  "retry_reason"
-                ],
-                "additionalProperties": false
-              }
-            },
-            "required": [
-              "step_id",
-              "parent_step",
-              "object_type",
-              "entry_id",
-              "operation_type",
-              "network",
-              "input",
-              "timestamp",
-              "status",
-              "dependencies"
-            ],
-            "additionalProperties": false
+            "type": "string"
           },
-          "description": "Substep records for trace_substeps."
+          "description": "Tags for add_object."
         },
-        "target_stage": {
-          "type": "integer",
-          "minimum": 1,
-          "maximum": 5,
-          "description": "Stage number (1-5) for validate_stage_unit, get_stage_assessment, get_stage_risk_policy, and rollback_stage (the stage to rollback to). Required by these 4 actions."
+        "object_id_remove": {
+          "type": "string",
+          "description": "ProjectObject UUID for remove_object (the project_objects.id, NOT the on-chain address)."
         },
-        "proposal_id": {
+        "object_id_update": {
           "type": "string",
-          "description": "Improvement proposal ID (for apply_improvement). Required by apply_improvement."
+          "description": "ProjectObject UUID for update_object (the project_objects.id)."
         },
-        "review_status": {
+        "object_name_update": {
           "type": "string",
-          "enum": [
-            "approved",
-            "rejected",
-            "applied"
-          ],
-          "description": "New review status to set (for apply_improvement). 'approved' triggers application (config_override or source_patch); 'rejected' marks as rejected; 'applied' marks as already applied."
+          "description": "New name for update_object."
         },
-        "queue_filter_status": {
+        "object_type_update": {
+          "type": "string",
+          "description": "New type for update_object."
+        },
+        "object_role_update": {
           "type": "string",
           "enum": [
-            "pending",
-            "approved",
-            "rejected",
-            "applied"
+            "core",
+            "dependency",
+            "reference"
           ],
-          "description": "Filter the improvement queue by review_status (for get_improvement_queue)."
+          "description": "New role for update_object."
         },
-        "queue_filter_type": {
+        "object_tags_update": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "New tags for update_object."
+        },
+        "version_description": {
           "type": "string",
-          "description": "Filter the improvement queue by proposal type (for get_improvement_queue)."
+          "maxLength": 500,
+          "description": "Description for create_version."
         },
-        "queue_filter_priority": {
+        "fork_from_version": {
           "type": "string",
-          "description": "Filter the improvement queue by priority P0/P1/P2/P3 (for get_improvement_queue)."
+          "description": "Source version for create_version (fork objects + graph from this version)."
         },
-        "dry_run": {
+        "max_depth": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 5,
+          "description": "Max recursion depth for Pathway 1 (internal reference derivation) in build_graph. Default 3."
+        },
+        "enable_registrar": {
           "type": "boolean",
-          "description": "When true, rollback_stage only evaluates the policy and returns the cleanup plan WITHOUT executing the rollback. Defaults to false (execute)."
+          "description": "Enable Pathway 2 (Registrar inbound query) in build_graph. Default true."
         },
-        "query_object_type": {
-          "type": "string",
-          "description": "Object type for get_reversibility query (e.g. 'service', 'machine', 'guard'). When omitted, returns the full matrix."
+        "enable_potential": {
+          "type": "boolean",
+          "description": "Enable Pathway 3 (potential relationship detection) in build_graph. Default false."
         },
-        "query_lifecycle_state": {
+        "evaluation_type": {
           "type": "string",
           "enum": [
-            "created",
-            "referenced",
-            "published",
-            "bound"
+            "risk",
+            "trust",
+            "completeness",
+            "value",
+            "worth_buying"
           ],
-          "description": "Object lifecycle state for get_reversibility query. When omitted, returns all lifecycle states for the given object_type."
+          "description": "Evaluation type for evaluate_project. risk/trust/completeness are rule-based (computed locally). worth_buying/value require LLM assistance (returns a prompt for the caller to process)."
         },
-        "context_objects": {
+        "refresh_before_eval": {
+          "type": "boolean",
+          "description": "When true, evaluate_project refreshes object cache from chain before evaluating. Default false."
+        },
+        "eval_score": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 100,
+          "description": "Overall evaluation score (0-100) for save_evaluation."
+        },
+        "eval_summary": {
+          "type": "string",
+          "maxLength": 1000,
+          "description": "Evaluation summary for save_evaluation."
+        },
+        "eval_details": {
+          "type": "object",
+          "additionalProperties": {},
+          "description": "Structured evaluation details for save_evaluation (criterion_scores, findings, etc.)."
+        },
+        "compare_project_ids": {
           "type": "array",
           "items": {
             "type": "string"
           },
-          "description": "Object IDs (0x...) or LocalMark names to assemble context for. Required when action='assemble_context'. The current on-chain state of each object will be queried and enriched with semantic annotations."
+          "minItems": 2,
+          "description": "Array of project IDs to compare (for compare_projects). Minimum 2."
         },
-        "include_events": {
-          "type": "boolean",
-          "description": "When true, assemble_context also queries recent state-transition events (NewOrderEvent, ProgressEvent, ArbEvent, etc.). Events are the real-time transition log — convergent and bounded. Defaults to false. Note: object-embedded history (ProgressSession.forwards, Order.disputes) is ALWAYS extracted automatically — no flag needed."
+        "diff_address": {
+          "type": "string",
+          "description": "Object address for get_object_diff."
         },
-        "context_network": {
+        "diff_from_time": {
+          "type": "integer",
+          "description": "Start timestamp (ms) for get_object_diff."
+        },
+        "diff_to_time": {
+          "type": "integer",
+          "description": "End timestamp (ms) for get_object_diff."
+        },
+        "network": {
           "type": "string",
           "enum": [
             "testnet",
             "mainnet"
           ],
-          "description": "Network for assemble_context queries. Defaults to 'testnet' if omitted."
+          "description": "Target network for generate_deployment_doc. Required when action='generate_deployment_doc'."
+        },
+        "save": {
+          "type": "boolean",
+          "description": "When true (default), persist the generated MD to SQLite project_documents table for generate_deployment_doc."
         }
       },
       "required": [