@wowok/agent-mcp 3.4.3 → 3.4.4

package/dist/schemas/industry_pack_operation.schema.json

@@ -1,582 +1 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://wowok.net/schemas/industry_pack_operation.json",
-  "title": "Industry Pack - Knowledge Template Orchestration",
-  "description": "Manage industry knowledge packs (distributable, registrable, versionable units carrying one industry's object-shape, matching rules, and role personae). Actions: scaffold (generate template skeleton), list (registered packs), scan (default directory).",
-  "type": "object",
-  "properties": {
-    "action": {
-      "type": "string",
-      "enum": [
-        "scaffold",
-        "list",
-        "scan",
-        "repair_builtin_templates",
-        "template_drift",
-        "resolve",
-        "list_files",
-        "read_file",
-        "write_file",
-        "get",
-        "capability_list",
-        "capability_get",
-        "compose_probe",
-        "product_cards",
-        "product_card",
-        "diff",
-        "reset",
-        "delete_file",
-        "create_file",
-        "create_dir",
-        "copy",
-        "move",
-        "rename",
-        "recommend_industry",
-        "list_modes",
-        "derive_user_mode",
-        "evolve_user_mode",
-        "register_user_mode",
-        "unregister_user_mode",
-        "register_custom_metric",
-        "unregister_custom_metric",
-        "register_custom_constraint",
-        "unregister_custom_constraint",
-        "list_metrics_constraints"
-      ],
-      "description": "Action: 'scaffold' = generate a pack template skeleton (requires name); 'list' = list registered packs; 'scan' = scan + register packs under the default directory; 'template_drift' = REPORT builtin template files whose on-disk body differs from the in-code catalog (classifies no_sentinel_legacy / stale_release / user_modified); run it FIRST when a template change 'seems to have no effect. 'repair_builtin_templates' = RESEED those legacy files from the in-code catalog (identity-gated on a known builtin id, previous body kept in the hidden templates/.archive/ dir; custom templates never touched)'resolve' = return the industry root directory; 'list_files' = list files under the industry directory; 'read_file' = read a file under the industry directory (path required); 'write_file' = write content to a file under the industry directory (path + content required); 'get' = return registered layer data for an industry (name required; mode/dispute/compliance/supply/rules/playbook; an optional 'layer' selector returns ONE layer and refuses by name when the pack does not register it — layer='template' reads the builtin catalog template data instead of pack layers, with 'template' id optional to list the industry's templates); 'capability_list' = list the Capability Lattice registry (composable business units; optional 'group' filter); 'capability_get' = full card of ONE capability id (intent/binds/requires/excludes/risks/disclosures/cost/constraints); 'compose_probe' = probe whether a capability selection can coexist in one build — static lattice check + optional base-template compile baseline (capabilities[] required; optional 'template' as the base build); 'product_cards' = FRONT-stage ProductCard summaries for the catalog or one industry (optional 'name'); 'product_card' = the full ProductCard of ONE builtin template (template id required) — alignment/features/cost/params/risks, every assertion projected from declared data; 'diff' = compare registered vs on-disk manifest version/layers (name required); 'reset' = restore a file or entire pack folder to its pristine annotated template (path required). 'delete_file' = delete a file or directory (path required). 'create_file' = create an empty file (path required; content optional). 'create_dir' = create a directory recursively (path required). 'copy' = copy a file or directory (from + to required). 'move' / 'rename' = move or rename a file or directory (from + to required). Mode registry (industry/scenario configuration): 'recommend_industry' = business intent → top-3 similar industries + reference examples; 'list_modes' = builtin + custom modes; 'derive_user_mode' = derive a custom mode from a builtin; 'evolve_user_mode' = iterate an existing custom mode; 'register_user_mode' = register a fully custom mode; 'unregister_user_mode' = delete a custom mode; 'register_custom_metric' / 'register_custom_constraint' = register global evaluation metric/constraint; 'list_metrics_constraints' = list metrics + constraints (filterable)."
-    },
-    "name": {
-      "description": "Industry name (lowercase snake_case, e.g. 'life_service'); required for scaffold and get.",
-      "type": "string"
-    },
-    "layer": {
-      "description": "Optional single-layer selector for action='get'. Non-template values return ONLY that registered pack layer and refuse with a named error when the pack does not register it (stub packs carry only mode/match). 'template' reads the builtin catalog: with 'template' set, one full template projection; without it, the industry's template summaries. 'params' is the merchant-facing settings surface: with 'template' set, every declared parameter of that template in business order (meaning, unit, default, accepted values, proven status, landing, editable); without a template id it requires 'query' and searches the catalog for the business facet. 'components' is the companion object surface: every Service/Sale/allocator/allocation/machine/guard/repository component with what it is, HOW to configure it (surface + field path) and WHEN, the effect once it takes effect, and the objects it is bound to — a component that cannot be configured states why (e.g. a money split hard-coded in the template body).",
-      "type": "string",
-      "enum": [
-        "mode",
-        "match",
-        "dispute",
-        "compliance",
-        "supply",
-        "rules",
-        "playbook",
-        "template",
-        "params",
-        "components"
-      ]
-    },
-    "query": {
-      "description": "Free-text business phrase (e.g. 'settlement window', 'take rate', 'cancel fee', 'allocator split', 'repository policy') used with action='get' + layer='params' or layer='components' to RANK that plane. A phrase that names nothing returns an empty match list — never the least-bad row.",
-      "type": "string"
-    },
-    "template": {
-      "description": "Builtin template id '<industry>/<variant>' (e.g. 'rental/p2p-shortstay'); used with action='get' + layer='template' / 'params' / 'components', and with action='compose_probe' as the base build the capability selection is probed against.",
-      "type": "string"
-    },
-    "capabilities": {
-      "description": "Capability ids (from capability_list) — required for action='compose_probe' (the selection to probe; 1..12 ids), echoed by capability_get.",
-      "maxItems": 12,
-      "type": "array",
-      "items": {
-        "type": "string",
-        "minLength": 1
-      }
-    },
-    "group": {
-      "description": "Capability group filter for action='capability_list': fund_safety / trust_evidence / fulfillment / promotion / governance / composition.",
-      "type": "string"
-    },
-    "path": {
-      "description": "Path relative to the industry root (required for read_file, write_file, reset, create_file, create_dir).",
-      "type": "string"
-    },
-    "content": {
-      "description": "Text content to write (required for write_file; optional for create_file).",
-      "type": "string"
-    },
-    "from": {
-      "description": "Source path relative to the industry root (required for copy/move/rename).",
-      "type": "string"
-    },
-    "to": {
-      "description": "Destination path relative to the industry root (required for copy/move/rename).",
-      "type": "string"
-    },
-    "authorize": {
-      "description": "EXPLICIT USER AUTHORIZATION (C5) required before any action that MODIFIES a user-editable template file (any path under '<industry>/templates/') — write_file / delete_file / reset / move / rename on such a path, copy ONTO an existing such file, and every repair_builtin_templates execution. WITHOUT this flag the action refuses (or returns a plan-only preview for repair_builtin_templates). Set it ONLY after the user has explicitly confirmed the specific change in the conversation.",
-      "type": "boolean"
-    },
-    "include_user_edited": {
-      "description": "Builtin template ids ('<industry>/<variant>') whose USER-EDIT PROTECTION is explicitly lifted for repair_builtin_templates / template_drift (b9-2). A sentinel whose hash no longer binds its body normally locks the file out of the seed-upgrade channel (presumed user edit); pass the ids the user EXPLICITLY approved for reseed after reviewing the field-level diff — e.g. machine-proven provenance rot (stale deployment stamp or an authorized write that updated the body without re-stamping). The list IS the per-file consent: it must ride BOTH the plan-only preview and the authorize=true execute call. Never list an id the user has not personally confirmed.",
-      "maxItems": 50,
-      "type": "array",
-      "items": {
-        "type": "string",
-        "minLength": 1
-      }
-    },
-    "intent": {
-      "description": "Business intent text for recommend_industry (e.g. 'I rent cameras to photographers with deposit and damage inspection'). Falls back to project_description / project_name when omitted.",
-      "type": "string",
-      "maxLength": 2000
-    },
-    "strategy": {
-      "description": "Persona strategy statement(s) for recommend_industry (e.g. 'push sales volume first' / 'keep gross margin >= 30%'). Bridged into mode ranking: objectives resolve to deterministic infrastructure levers (discount / reward / buy_guard / machine_design) and re-rank the industry recommendations by lever alignment. Pass the persona's strategy[] entries here.",
-      "anyOf": [
-        {
-          "type": "string",
-          "maxLength": 2000
-        },
-        {
-          "maxItems": 10,
-          "type": "array",
-          "items": {
-            "type": "string",
-            "maxLength": 2000
-          }
-        }
-      ]
-    },
-    "semantic_ir": {
-      "description": "Canonical Semantic IR for recommend_industry, produced by the CALLING agent (this server runs no LLM). Use it when the intent is not English, or is phrased outside the English keyword lexicon: translate the business description into this fixed shape and let the server decide. The server validates the IR, merges it with keyword inference (IR evidence wins conflicts, keywords remain the fallback) and echoes the canonical artifact + sha256 digest for freeze/replay. Shape: {schema_version: 2 (1 still accepted), locale: '<BCP-47>', traits: [{trait, value, confidence: 0..1, span?: {start,end}, quote?}], domains: [{domain, confidence?}], claims: [{key, value, confidence?}], discovery: {industry?, tags?: string[], product_ref?, english_summary?, confidence?}, provenance: {source: 'caller_llm', model?, prompt_version?}}. traits vocabulary (10 dimensions): has_logistics, communication_heavy, pure_digital, long_cycle, deposit_required, multi_tier_allocation (boolean); regulatory_intensity, trust_sensitivity (low|medium|high); consumption_frequency (one_time|occasional|frequent); avg_ticket_size (micro|small|medium|large). domains vocabulary: travel_accommodation. claims vocabulary: reward_pool_amount. discovery is the language-neutral business-model layer: tags use the CLOSED vocabulary returned by template_list.discovery_vocabulary (canonical English tokens, never locale words), industry is a registered industry name, product_ref is a benchmark-product slug, and english_summary is a translation aid used only for keyword fallback. An applied discovery.industry ranks that industry with a domain-prior boost. Rules: emit evidence only (no free-form prose), one entry per dimension, copy spans/quotes VERBATIM from the intent (unlocatable evidence is dropped and reported), confidence below 0.5 is recorded but not applied, and unknown traits/domains/tags/industries/product_refs are dropped and reported in semantic_ir_issues.",
-      "type": "object",
-      "properties": {
-        "schema_version": {
-          "anyOf": [
-            {
-              "type": "number",
-              "const": 1
-            },
-            {
-              "type": "number",
-              "const": 2
-            }
-          ]
-        },
-        "locale": {
-          "type": "string",
-          "minLength": 2,
-          "maxLength": 35
-        },
-        "traits": {
-          "maxItems": 20,
-          "type": "array",
-          "items": {
-            "type": "object",
-            "properties": {
-              "trait": {
-                "type": "string",
-                "maxLength": 64
-              },
-              "value": {
-                "anyOf": [
-                  {
-                    "type": "boolean"
-                  },
-                  {
-                    "type": "string",
-                    "maxLength": 32
-                  }
-                ]
-              },
-              "confidence": {
-                "type": "number"
-              },
-              "span": {
-                "type": "object",
-                "properties": {
-                  "start": {
-                    "type": "integer",
-                    "minimum": 0,
-                    "maximum": 9007199254740991
-                  },
-                  "end": {
-                    "type": "integer",
-                    "minimum": 0,
-                    "maximum": 9007199254740991
-                  }
-                },
-                "required": [
-                  "start",
-                  "end"
-                ],
-                "additionalProperties": false
-              },
-              "quote": {
-                "type": "string",
-                "maxLength": 300
-              }
-            },
-            "required": [
-              "trait",
-              "value",
-              "confidence"
-            ],
-            "additionalProperties": false
-          }
-        },
-        "domains": {
-          "maxItems": 10,
-          "type": "array",
-          "items": {
-            "type": "object",
-            "properties": {
-              "domain": {
-                "type": "string",
-                "maxLength": 64
-              },
-              "confidence": {
-                "type": "number"
-              },
-              "span": {
-                "type": "object",
-                "properties": {
-                  "start": {
-                    "type": "integer",
-                    "minimum": 0,
-                    "maximum": 9007199254740991
-                  },
-                  "end": {
-                    "type": "integer",
-                    "minimum": 0,
-                    "maximum": 9007199254740991
-                  }
-                },
-                "required": [
-                  "start",
-                  "end"
-                ],
-                "additionalProperties": false
-              },
-              "quote": {
-                "type": "string",
-                "maxLength": 300
-              }
-            },
-            "required": [
-              "domain"
-            ],
-            "additionalProperties": false
-          }
-        },
-        "claims": {
-          "maxItems": 10,
-          "type": "array",
-          "items": {
-            "type": "object",
-            "properties": {
-              "key": {
-                "type": "string",
-                "maxLength": 64
-              },
-              "value": {
-                "type": "number"
-              },
-              "confidence": {
-                "type": "number"
-              },
-              "span": {
-                "type": "object",
-                "properties": {
-                  "start": {
-                    "type": "integer",
-                    "minimum": 0,
-                    "maximum": 9007199254740991
-                  },
-                  "end": {
-                    "type": "integer",
-                    "minimum": 0,
-                    "maximum": 9007199254740991
-                  }
-                },
-                "required": [
-                  "start",
-                  "end"
-                ],
-                "additionalProperties": false
-              },
-              "quote": {
-                "type": "string",
-                "maxLength": 300
-              }
-            },
-            "required": [
-              "key",
-              "value"
-            ],
-            "additionalProperties": false
-          }
-        },
-        "discovery": {
-          "type": "object",
-          "properties": {
-            "industry": {
-              "type": "string",
-              "maxLength": 64
-            },
-            "tags": {
-              "maxItems": 20,
-              "type": "array",
-              "items": {
-                "type": "string",
-                "maxLength": 64
-              }
-            },
-            "product_ref": {
-              "type": "string",
-              "maxLength": 64
-            },
-            "english_summary": {
-              "type": "string",
-              "maxLength": 600
-            },
-            "confidence": {
-              "type": "number"
-            }
-          },
-          "additionalProperties": false
-        },
-        "provenance": {
-          "type": "object",
-          "properties": {
-            "source": {
-              "type": "string",
-              "enum": [
-                "caller_llm",
-                "human"
-              ]
-            },
-            "model": {
-              "type": "string",
-              "maxLength": 120
-            },
-            "prompt_version": {
-              "type": "string",
-              "maxLength": 60
-            },
-            "generated_at": {
-              "type": "integer",
-              "minimum": 0,
-              "maximum": 9007199254740991
-            }
-          },
-          "required": [
-            "source"
-          ],
-          "additionalProperties": false
-        }
-      },
-      "required": [
-        "schema_version",
-        "locale",
-        "provenance"
-      ],
-      "additionalProperties": false
-    },
-    "mode_source": {
-      "description": "Source builtin mode name for derive_user_mode (e.g. 'freelance'). Call list_modes to see available modes.",
-      "type": "string"
-    },
-    "mode_name": {
-      "description": "Mode name for derive_user_mode (new mode name), evolve_user_mode / unregister_user_mode (existing custom mode), register_user_mode (new mode name). Must NOT conflict with builtin mode names.",
-      "type": "string",
-      "maxLength": 100
-    },
-    "mode_display_name": {
-      "description": "Display name for derive_user_mode / register_user_mode. Defaults to mode_name.",
-      "type": "string",
-      "maxLength": 200
-    },
-    "mode_changes": {
-      "description": "Mode field overrides for derive_user_mode / evolve_user_mode / register_user_mode. For register_user_mode, REQUIRED fields: machine_shape (non-empty array of {name, role}) and key_risk (string). Common overrides: machine_shape (array of {name:string, role:string}), config_overrides (per-object config), allocator, guards, build_notes, risk_appetite. R-M1-11 ENFORCED: machine_shape node names must NOT contain dispute/refund/arb terms.",
-      "type": "object",
-      "propertyNames": {
-        "type": "string"
-      },
-      "additionalProperties": {}
-    },
-    "mode_change_description": {
-      "description": "Change description for evolve_user_mode (recorded in evolution history).",
-      "type": "string",
-      "maxLength": 500
-    },
-    "mode_bump_version": {
-      "description": "Whether evolve_user_mode bumps the patch version (default true: v1.0 → v1.1).",
-      "type": "boolean"
-    },
-    "metric_id": {
-      "description": "Unique metric ID for register_custom_metric (e.g. 'seasonality_risk').",
-      "type": "string",
-      "maxLength": 100
-    },
-    "metric_display_name": {
-      "description": "Display name for register_custom_metric.",
-      "type": "string",
-      "maxLength": 200
-    },
-    "metric_description": {
-      "description": "Description for register_custom_metric.",
-      "type": "string",
-      "maxLength": 1000
-    },
-    "metric_type": {
-      "description": "Metric type for register_custom_metric: 'risk' (negative) or 'benefit' (positive).",
-      "type": "string",
-      "enum": [
-        "risk",
-        "benefit"
-      ]
-    },
-    "metric_scale": {
-      "description": "Metric scale for register_custom_metric: 'level' (high/medium/low), 'numeric', or 'percentage'.",
-      "type": "string",
-      "enum": [
-        "level",
-        "numeric",
-        "percentage"
-      ]
-    },
-    "metric_weight": {
-      "description": "Metric weight for register_custom_metric (default 1.0).",
-      "type": "number",
-      "minimum": 0,
-      "maximum": 10
-    },
-    "constraint_id": {
-      "description": "Unique constraint ID for register_custom_constraint.",
-      "type": "string",
-      "maxLength": 100
-    },
-    "constraint_display_name": {
-      "description": "Display name for register_custom_constraint.",
-      "type": "string",
-      "maxLength": 200
-    },
-    "constraint_description": {
-      "description": "Description for register_custom_constraint.",
-      "type": "string",
-      "maxLength": 1000
-    },
-    "constraint_rule": {
-      "description": "Constraint rule for register_custom_constraint. 4 types: capability_required/capability_forbidden (capability_id), numeric_limit (field + max/min), condition_required (natural-language condition, AI-evaluated).",
-      "oneOf": [
-        {
-          "type": "object",
-          "properties": {
-            "type": {
-              "type": "string",
-              "const": "capability_required"
-            },
-            "capability_id": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "type",
-            "capability_id"
-          ],
-          "additionalProperties": false
-        },
-        {
-          "type": "object",
-          "properties": {
-            "type": {
-              "type": "string",
-              "const": "capability_forbidden"
-            },
-            "capability_id": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "type",
-            "capability_id"
-          ],
-          "additionalProperties": false
-        },
-        {
-          "type": "object",
-          "properties": {
-            "type": {
-              "type": "string",
-              "const": "numeric_limit"
-            },
-            "field": {
-              "type": "string"
-            },
-            "max": {
-              "type": "number"
-            },
-            "min": {
-              "type": "number"
-            }
-          },
-          "required": [
-            "type",
-            "field"
-          ],
-          "additionalProperties": false
-        },
-        {
-          "type": "object",
-          "properties": {
-            "type": {
-              "type": "string",
-              "const": "condition_required"
-            },
-            "condition": {
-              "type": "string"
-            },
-            "ai_evaluated": {
-              "type": "boolean",
-              "const": true
-            }
-          },
-          "required": [
-            "type",
-            "condition",
-            "ai_evaluated"
-          ],
-          "additionalProperties": false
-        }
-      ]
-    },
-    "constraint_severity": {
-      "description": "Constraint severity for register_custom_constraint: 'hard' blocks applyTemplate on violation; 'soft' only warns (default 'soft').",
-      "type": "string",
-      "enum": [
-        "hard",
-        "soft"
-      ]
-    },
-    "constraint_on_violation": {
-      "description": "Violation action for register_custom_constraint (default 'warn').",
-      "type": "string",
-      "enum": [
-        "block",
-        "warn",
-        "log"
-      ]
-    },
-    "metric_type_filter": {
-      "description": "Filter list_metrics_constraints by metric type.",
-      "type": "string",
-      "enum": [
-        "risk",
-        "benefit"
-      ]
-    },
-    "scope_filter": {
-      "description": "Filter list_metrics_constraints by scope (builtin or custom).",
-      "type": "string",
-      "enum": [
-        "builtin",
-        "custom"
-      ]
-    }
-  },
-  "required": [
-    "action"
-  ],
-  "additionalProperties": false
-}
+{"$schema":"http://json-schema.org/draft-07/schema#","$id":"https://wowok.net/schemas/industry_pack_operation.json","title":"Industry Pack - Knowledge Template Orchestration","description":"Manage industry knowledge packs (distributable, registrable, versionable units carrying one industry's object-shape, matching rules, and role personae). Actions: scaffold (generate template skeleton), list (registered packs), scan (default directory).","type":"object","properties":{"action":{"type":"string","enum":["scaffold","list","scan","repair_builtin_templates","template_drift","resolve","list_files","read_file","write_file","get","capability_list","capability_get","compose_probe","product_cards","product_card","diff","reset","delete_file","create_file","create_dir","copy","move","rename","recommend_industry","list_modes","derive_user_mode","evolve_user_mode","register_user_mode","unregister_user_mode","register_custom_metric","unregister_custom_metric","register_custom_constraint","unregister_custom_constraint","list_metrics_constraints"],"description":"Action: 'scaffold' = generate a pack template skeleton (requires name); 'list' = list registered packs; 'scan' = scan + register packs under the default directory; 'template_drift' = REPORT builtin template files whose on-disk body differs from the in-code catalog (classifies no_sentinel_legacy / stale_release / user_modified); run it FIRST when a template change 'seems to have no effect. 'repair_builtin_templates' = RESEED those legacy files from the in-code catalog (identity-gated on a known builtin id, previous body kept in the hidden templates/.archive/ dir; custom templates never touched)'resolve' = return the industry root directory; 'list_files' = list files under the industry directory; 'read_file' = read a file under the industry directory (path required); 'write_file' = write content to a file under the industry directory (path + content required); 'get' = return registered layer data for an industry (name required; mode/dispute/compliance/supply/rules/playbook; an optional 'layer' selector returns ONE layer and refuses by name when the pack does not register it — layer='template' reads the builtin catalog template data instead of pack layers, with 'template' id optional to list the industry's templates); 'capability_list' = list the Capability Lattice registry (composable business units; optional 'group' filter); 'capability_get' = full card of ONE capability id (intent/binds/requires/excludes/risks/disclosures/cost/constraints); 'compose_probe' = probe whether a capability selection can coexist in one build — static lattice check + optional base-template compile baseline (capabilities[] required; optional 'template' as the base build); 'product_cards' = FRONT-stage ProductCard summaries for the catalog or one industry (optional 'name'); 'product_card' = the full ProductCard of ONE builtin template (template id required) — alignment/features/cost/params/risks, every assertion projected from declared data; 'diff' = compare registered vs on-disk manifest version/layers (name required); 'reset' = restore a file or entire pack folder to its pristine annotated template (path required). 'delete_file' = delete a file or directory (path required). 'create_file' = create an empty file (path required; content optional). 'create_dir' = create a directory recursively (path required). 'copy' = copy a file or directory (from + to required). 'move' / 'rename' = move or rename a file or directory (from + to required). Mode registry (industry/scenario configuration): 'recommend_industry' = business intent → top-3 similar industries + reference examples; 'list_modes' = builtin + custom modes; 'derive_user_mode' = derive a custom mode from a builtin; 'evolve_user_mode' = iterate an existing custom mode; 'register_user_mode' = register a fully custom mode; 'unregister_user_mode' = delete a custom mode; 'register_custom_metric' / 'register_custom_constraint' = register global evaluation metric/constraint; 'list_metrics_constraints' = list metrics + constraints (filterable)."},"name":{"description":"Industry name (lowercase snake_case, e.g. 'life_service'); required for scaffold and get.","type":"string"},"layer":{"description":"Optional single-layer selector for action='get'. Non-template values return ONLY that registered pack layer and refuse with a named error when the pack does not register it (stub packs carry only mode/match). 'template' reads the builtin catalog: with 'template' set, one full template projection; without it, the industry's template summaries. 'params' is the merchant-facing settings surface: with 'template' set, every declared parameter of that template in business order (meaning, unit, default, accepted values, proven status, landing, editable); without a template id it requires 'query' and searches the catalog for the business facet. 'components' is the companion object surface: every Service/Sale/allocator/allocation/machine/guard/repository component with what it is, HOW to configure it (surface + field path) and WHEN, the effect once it takes effect, and the objects it is bound to — a component that cannot be configured states why (e.g. a money split hard-coded in the template body).","type":"string","enum":["mode","match","dispute","compliance","supply","rules","playbook","template","params","components"]},"query":{"description":"Free-text business phrase (e.g. 'settlement window', 'take rate', 'cancel fee', 'allocator split', 'repository policy') used with action='get' + layer='params' or layer='components' to RANK that plane. A phrase that names nothing returns an empty match list — never the least-bad row.","type":"string"},"template":{"description":"Builtin template id '<industry>/<variant>' (e.g. 'rental/p2p-shortstay'); used with action='get' + layer='template' / 'params' / 'components', and with action='compose_probe' as the base build the capability selection is probed against.","type":"string"},"capabilities":{"description":"Capability ids (from capability_list) — required for action='compose_probe' (the selection to probe; 1..12 ids), echoed by capability_get.","maxItems":12,"type":"array","items":{"type":"string","minLength":1}},"group":{"description":"Capability group filter for action='capability_list': fund_safety / trust_evidence / fulfillment / promotion / governance / composition.","type":"string"},"path":{"description":"Path relative to the industry root (required for read_file, write_file, reset, create_file, create_dir).","type":"string"},"content":{"description":"Text content to write (required for write_file; optional for create_file).","type":"string"},"from":{"description":"Source path relative to the industry root (required for copy/move/rename).","type":"string"},"to":{"description":"Destination path relative to the industry root (required for copy/move/rename).","type":"string"},"authorize":{"description":"EXPLICIT USER AUTHORIZATION (C5) required before any action that MODIFIES a user-editable template file (any path under '<industry>/templates/') — write_file / delete_file / reset / move / rename on such a path, copy ONTO an existing such file, and every repair_builtin_templates execution. WITHOUT this flag the action refuses (or returns a plan-only preview for repair_builtin_templates). Set it ONLY after the user has explicitly confirmed the specific change in the conversation.","type":"boolean"},"include_user_edited":{"description":"Builtin template ids ('<industry>/<variant>') whose USER-EDIT PROTECTION is explicitly lifted for repair_builtin_templates / template_drift (b9-2). A sentinel whose hash no longer binds its body normally locks the file out of the seed-upgrade channel (presumed user edit); pass the ids the user EXPLICITLY approved for reseed after reviewing the field-level diff — e.g. machine-proven provenance rot (stale deployment stamp or an authorized write that updated the body without re-stamping). The list IS the per-file consent: it must ride BOTH the plan-only preview and the authorize=true execute call. Never list an id the user has not personally confirmed.","maxItems":50,"type":"array","items":{"type":"string","minLength":1}},"intent":{"description":"Business intent text for recommend_industry (e.g. 'I rent cameras to photographers with deposit and damage inspection'). Falls back to project_description / project_name when omitted.","type":"string","maxLength":2000},"strategy":{"description":"Persona strategy statement(s) for recommend_industry (e.g. 'push sales volume first' / 'keep gross margin >= 30%'). Bridged into mode ranking: objectives resolve to deterministic infrastructure levers (discount / reward / buy_guard / machine_design) and re-rank the industry recommendations by lever alignment. Pass the persona's strategy[] entries here.","anyOf":[{"type":"string","maxLength":2000},{"maxItems":10,"type":"array","items":{"type":"string","maxLength":2000}}]},"semantic_ir":{"description":"Canonical Semantic IR for recommend_industry, produced by the CALLING agent (this server runs no LLM). Use it when the intent is not English, or is phrased outside the English keyword lexicon: translate the business description into this fixed shape and let the server decide. The server validates the IR, merges it with keyword inference (IR evidence wins conflicts, keywords remain the fallback) and echoes the canonical artifact + sha256 digest for freeze/replay. Shape: {schema_version: 2 (1 still accepted), locale: '<BCP-47>', traits: [{trait, value, confidence: 0..1, span?: {start,end}, quote?}], domains: [{domain, confidence?}], claims: [{key, value, confidence?}], discovery: {industry?, tags?: string[], product_ref?, english_summary?, confidence?}, provenance: {source: 'caller_llm', model?, prompt_version?}}. traits vocabulary (10 dimensions): has_logistics, communication_heavy, pure_digital, long_cycle, deposit_required, multi_tier_allocation (boolean); regulatory_intensity, trust_sensitivity (low|medium|high); consumption_frequency (one_time|occasional|frequent); avg_ticket_size (micro|small|medium|large). domains vocabulary: travel_accommodation. claims vocabulary: reward_pool_amount. discovery is the language-neutral business-model layer: tags use the CLOSED vocabulary returned by template_list.discovery_vocabulary (canonical English tokens, never locale words), industry is a registered industry name, product_ref is a benchmark-product slug, and english_summary is a translation aid used only for keyword fallback. An applied discovery.industry ranks that industry with a domain-prior boost. Rules: emit evidence only (no free-form prose), one entry per dimension, copy spans/quotes VERBATIM from the intent (unlocatable evidence is dropped and reported), confidence below 0.5 is recorded but not applied, and unknown traits/domains/tags/industries/product_refs are dropped and reported in semantic_ir_issues.","type":"object","properties":{"schema_version":{"anyOf":[{"type":"number","const":1},{"type":"number","const":2}]},"locale":{"type":"string","minLength":2,"maxLength":35},"traits":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"trait":{"type":"string","maxLength":64},"value":{"anyOf":[{"type":"boolean"},{"type":"string","maxLength":32}]},"confidence":{"type":"number"},"span":{"type":"object","properties":{"start":{"type":"integer","minimum":0,"maximum":9007199254740991},"end":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["start","end"],"additionalProperties":false},"quote":{"type":"string","maxLength":300}},"required":["trait","value","confidence"],"additionalProperties":false}},"domains":{"maxItems":10,"type":"array","items":{"type":"object","properties":{"domain":{"type":"string","maxLength":64},"confidence":{"type":"number"},"span":{"type":"object","properties":{"start":{"type":"integer","minimum":0,"maximum":9007199254740991},"end":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["start","end"],"additionalProperties":false},"quote":{"type":"string","maxLength":300}},"required":["domain"],"additionalProperties":false}},"claims":{"maxItems":10,"type":"array","items":{"type":"object","properties":{"key":{"type":"string","maxLength":64},"value":{"type":"number"},"confidence":{"type":"number"},"span":{"type":"object","properties":{"start":{"type":"integer","minimum":0,"maximum":9007199254740991},"end":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["start","end"],"additionalProperties":false},"quote":{"type":"string","maxLength":300}},"required":["key","value"],"additionalProperties":false}},"discovery":{"type":"object","properties":{"industry":{"type":"string","maxLength":64},"tags":{"maxItems":20,"type":"array","items":{"type":"string","maxLength":64}},"product_ref":{"type":"string","maxLength":64},"english_summary":{"type":"string","maxLength":600},"confidence":{"type":"number"}},"additionalProperties":false},"provenance":{"type":"object","properties":{"source":{"type":"string","enum":["caller_llm","human"]},"model":{"type":"string","maxLength":120},"prompt_version":{"type":"string","maxLength":60},"generated_at":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["source"],"additionalProperties":false}},"required":["schema_version","locale","provenance"],"additionalProperties":false},"mode_source":{"description":"Source builtin mode name for derive_user_mode (e.g. 'freelance'). Call list_modes to see available modes.","type":"string"},"mode_name":{"description":"Mode name for derive_user_mode (new mode name), evolve_user_mode / unregister_user_mode (existing custom mode), register_user_mode (new mode name). Must NOT conflict with builtin mode names.","type":"string","maxLength":100},"mode_display_name":{"description":"Display name for derive_user_mode / register_user_mode. Defaults to mode_name.","type":"string","maxLength":200},"mode_changes":{"description":"Mode field overrides for derive_user_mode / evolve_user_mode / register_user_mode. For register_user_mode, REQUIRED fields: machine_shape (non-empty array of {name, role}) and key_risk (string). Common overrides: machine_shape (array of {name:string, role:string}), config_overrides (per-object config), allocator, guards, build_notes, risk_appetite. R-M1-11 ENFORCED: machine_shape node names must NOT contain dispute/refund/arb terms.","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"mode_change_description":{"description":"Change description for evolve_user_mode (recorded in evolution history).","type":"string","maxLength":500},"mode_bump_version":{"description":"Whether evolve_user_mode bumps the patch version (default true: v1.0 → v1.1).","type":"boolean"},"metric_id":{"description":"Unique metric ID for register_custom_metric (e.g. 'seasonality_risk').","type":"string","maxLength":100},"metric_display_name":{"description":"Display name for register_custom_metric.","type":"string","maxLength":200},"metric_description":{"description":"Description for register_custom_metric.","type":"string","maxLength":1000},"metric_type":{"description":"Metric type for register_custom_metric: 'risk' (negative) or 'benefit' (positive).","type":"string","enum":["risk","benefit"]},"metric_scale":{"description":"Metric scale for register_custom_metric: 'level' (high/medium/low), 'numeric', or 'percentage'.","type":"string","enum":["level","numeric","percentage"]},"metric_weight":{"description":"Metric weight for register_custom_metric (default 1.0).","type":"number","minimum":0,"maximum":10},"constraint_id":{"description":"Unique constraint ID for register_custom_constraint.","type":"string","maxLength":100},"constraint_display_name":{"description":"Display name for register_custom_constraint.","type":"string","maxLength":200},"constraint_description":{"description":"Description for register_custom_constraint.","type":"string","maxLength":1000},"constraint_rule":{"description":"Constraint rule for register_custom_constraint. 4 types: capability_required/capability_forbidden (capability_id), numeric_limit (field + max/min), condition_required (natural-language condition, AI-evaluated).","oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"capability_required"},"capability_id":{"type":"string"}},"required":["type","capability_id"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"capability_forbidden"},"capability_id":{"type":"string"}},"required":["type","capability_id"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"numeric_limit"},"field":{"type":"string"},"max":{"type":"number"},"min":{"type":"number"}},"required":["type","field"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"condition_required"},"condition":{"type":"string"},"ai_evaluated":{"type":"boolean","const":true}},"required":["type","condition","ai_evaluated"],"additionalProperties":false}]},"constraint_severity":{"description":"Constraint severity for register_custom_constraint: 'hard' blocks applyTemplate on violation; 'soft' only warns (default 'soft').","type":"string","enum":["hard","soft"]},"constraint_on_violation":{"description":"Violation action for register_custom_constraint (default 'warn').","type":"string","enum":["block","warn","log"]},"metric_type_filter":{"description":"Filter list_metrics_constraints by metric type.","type":"string","enum":["risk","benefit"]},"scope_filter":{"description":"Filter list_metrics_constraints by scope (builtin or custom).","type":"string","enum":["builtin","custom"]}},"required":["action"],"additionalProperties":false}