@wowok/agent-mcp 3.0.4 → 3.0.5

package/dist/schemas/strategy_review_operation.output.json

@@ -0,0 +1,532 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://wowok.net/schemas/strategy_review_operation.output.json",
+  "title": "Strategy Review - Posture-Weighted Scorecard & Periodic Review",
+  "description": "Evidence-driven operating review for one merchant account in one industry. Actions: collect (gather evidence across 6 sources, persist one append-only local snapshot), review (fresh evidence without persisting; posture-weighted 0-100 score, period deltas, deterministic pricing/posture recommendations, cadence, <=2 current-layer persona proposals that are only applied via explicit persona_operation apply), list_snapshots (stored history).",
+  "type": "object",
+  "properties": {
+    "result": {
+      "oneOf": [
+        {
+          "type": "object",
+          "properties": {
+            "action": {
+              "type": "string",
+              "const": "collect"
+            },
+            "snapshot_id": {
+              "type": "string"
+            },
+            "stored": {
+              "type": "boolean",
+              "description": "Whether the snapshot was persisted (false = storage failed fail-soft; collection still returned)."
+            },
+            "storage_error": {
+              "type": "string"
+            },
+            "posture": {
+              "type": "string",
+              "enum": [
+                "volume",
+                "balanced",
+                "margin"
+              ]
+            },
+            "collection": {
+              "type": "object",
+              "properties": {
+                "account": {
+                  "type": "string"
+                },
+                "industry": {
+                  "type": "string"
+                },
+                "network": {
+                  "type": "string"
+                },
+                "collected_at": {
+                  "type": "number"
+                },
+                "metrics": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "id": {
+                        "type": "string",
+                        "description": "Catalog metric id, e.g. order_count, repeat_customer_rate."
+                      },
+                      "source": {
+                        "type": "string",
+                        "description": "Which evidence source produced it."
+                      },
+                      "status": {
+                        "type": "string",
+                        "enum": [
+                          "ok",
+                          "unavailable",
+                          "error"
+                        ],
+                        "description": "ok = value present; unavailable = source returned no evidence; error = source failed (degraded, never zero-filled)."
+                      },
+                      "value": {
+                        "anyOf": [
+                          {
+                            "type": "number"
+                          },
+                          {
+                            "type": "null"
+                          }
+                        ]
+                      },
+                      "reason": {
+                        "description": "Why status is unavailable/error, when known.",
+                        "type": "string"
+                      },
+                      "collected_at": {
+                        "type": "number"
+                      }
+                    },
+                    "required": [
+                      "id",
+                      "source",
+                      "status",
+                      "collected_at"
+                    ],
+                    "additionalProperties": false
+                  }
+                },
+                "unavailable": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "Metric ids with no evidence this cycle."
+                },
+                "errors": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "Evidence sources that failed this cycle."
+                }
+              },
+              "required": [
+                "account",
+                "industry",
+                "network",
+                "collected_at",
+                "metrics",
+                "unavailable",
+                "errors"
+              ],
+              "additionalProperties": false
+            }
+          },
+          "required": [
+            "action",
+            "snapshot_id",
+            "stored",
+            "posture",
+            "collection"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "action": {
+              "type": "string",
+              "const": "review"
+            },
+            "review": {
+              "type": "object",
+              "properties": {
+                "account": {
+                  "type": "string"
+                },
+                "industry": {
+                  "type": "string"
+                },
+                "posture": {
+                  "type": "string",
+                  "enum": [
+                    "volume",
+                    "balanced",
+                    "margin"
+                  ]
+                },
+                "generated_at": {
+                  "type": "number"
+                },
+                "scorecard": {
+                  "type": "object",
+                  "properties": {
+                    "posture": {
+                      "type": "string",
+                      "enum": [
+                        "volume",
+                        "balanced",
+                        "margin"
+                      ]
+                    },
+                    "overall": {
+                      "anyOf": [
+                        {
+                          "type": "number"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ],
+                      "description": "0–100 renormalized over available anchored metrics; null when no SHOP-performance evidence exists (market-environment metrics alone never grade the shop)."
+                    },
+                    "scored_metric_count": {
+                      "type": "number"
+                    },
+                    "metric_scores": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "id": {
+                            "type": "string"
+                          },
+                          "label": {
+                            "type": "string"
+                          },
+                          "status": {
+                            "type": "string",
+                            "enum": [
+                              "ok",
+                              "unavailable",
+                              "error"
+                            ]
+                          },
+                          "value": {
+                            "anyOf": [
+                              {
+                                "type": "number"
+                              },
+                              {
+                                "type": "null"
+                              }
+                            ]
+                          },
+                          "weight": {
+                            "type": "number",
+                            "description": "Posture-specific weight actually applied."
+                          },
+                          "score": {
+                            "anyOf": [
+                              {
+                                "type": "number"
+                              },
+                              {
+                                "type": "null"
+                              }
+                            ],
+                            "description": "0–100 anchored score; null for contextual/unavailable metrics."
+                          },
+                          "delta": {
+                            "anyOf": [
+                              {
+                                "type": "object",
+                                "properties": {
+                                  "id": {
+                                    "type": "string"
+                                  },
+                                  "from": {
+                                    "type": "number"
+                                  },
+                                  "to": {
+                                    "type": "number"
+                                  },
+                                  "change": {
+                                    "type": "number"
+                                  },
+                                  "direction": {
+                                    "type": "string",
+                                    "enum": [
+                                      "up",
+                                      "down",
+                                      "flat"
+                                    ]
+                                  },
+                                  "improved": {
+                                    "anyOf": [
+                                      {
+                                        "type": "boolean"
+                                      },
+                                      {
+                                        "type": "null"
+                                      }
+                                    ],
+                                    "description": "Whether the change is good for this metric; null when flat/unoriented."
+                                  }
+                                },
+                                "required": [
+                                  "id",
+                                  "from",
+                                  "to",
+                                  "change",
+                                  "direction",
+                                  "improved"
+                                ],
+                                "additionalProperties": false
+                              },
+                              {
+                                "type": "null"
+                              }
+                            ]
+                          }
+                        },
+                        "required": [
+                          "id",
+                          "label",
+                          "status",
+                          "value",
+                          "weight",
+                          "score",
+                          "delta"
+                        ],
+                        "additionalProperties": false
+                      }
+                    },
+                    "unavailable": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    }
+                  },
+                  "required": [
+                    "posture",
+                    "overall",
+                    "scored_metric_count",
+                    "metric_scores",
+                    "unavailable"
+                  ],
+                  "additionalProperties": false
+                },
+                "cadence": {
+                  "type": "object",
+                  "properties": {
+                    "cadence_days": {
+                      "type": "number"
+                    },
+                    "days_since_last": {
+                      "anyOf": [
+                        {
+                          "type": "number"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
+                    "due": {
+                      "type": "boolean"
+                    },
+                    "next_review_after": {
+                      "anyOf": [
+                        {
+                          "type": "number"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    }
+                  },
+                  "required": [
+                    "cadence_days",
+                    "days_since_last",
+                    "due",
+                    "next_review_after"
+                  ],
+                  "additionalProperties": false
+                },
+                "summary": {
+                  "type": "string",
+                  "description": "Markdown review card body."
+                },
+                "findings": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
+                "recommendations": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
+                "proposals": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "id": {
+                        "type": "string"
+                      },
+                      "rationale": {
+                        "type": "string"
+                      },
+                      "target_layer": {
+                        "type": "string",
+                        "const": "current",
+                        "description": "AI-generated proposals may only touch the CURRENT persona layer."
+                      },
+                      "delta": {
+                        "type": "object",
+                        "propertyNames": {
+                          "type": "string"
+                        },
+                        "additionalProperties": {},
+                        "description": "Partial PersonaLayer to merge; applied ONLY via explicit user confirmation."
+                      },
+                      "apply_via": {
+                        "type": "object",
+                        "properties": {
+                          "tool": {
+                            "type": "string",
+                            "const": "persona_operation"
+                          },
+                          "action": {
+                            "type": "string",
+                            "const": "apply_delta"
+                          },
+                          "note": {
+                            "type": "string"
+                          }
+                        },
+                        "required": [
+                          "tool",
+                          "action",
+                          "note"
+                        ],
+                        "additionalProperties": false
+                      }
+                    },
+                    "required": [
+                      "id",
+                      "rationale",
+                      "target_layer",
+                      "delta",
+                      "apply_via"
+                    ],
+                    "additionalProperties": false
+                  },
+                  "description": "At most two current-layer proposals; NEVER applied automatically."
+                },
+                "unavailable": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                }
+              },
+              "required": [
+                "account",
+                "industry",
+                "posture",
+                "generated_at",
+                "scorecard",
+                "cadence",
+                "summary",
+                "findings",
+                "recommendations",
+                "proposals",
+                "unavailable"
+              ],
+              "additionalProperties": false
+            },
+            "previous_snapshot_id": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Snapshot id the deltas were computed against; null when there is no history."
+            }
+          },
+          "required": [
+            "action",
+            "review",
+            "previous_snapshot_id"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "action": {
+              "type": "string",
+              "const": "list_snapshots"
+            },
+            "snapshots": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "type": "string"
+                  },
+                  "account": {
+                    "type": "string"
+                  },
+                  "industry": {
+                    "type": "string"
+                  },
+                  "posture": {
+                    "anyOf": [
+                      {
+                        "type": "string",
+                        "enum": [
+                          "volume",
+                          "balanced",
+                          "margin"
+                        ]
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "collected_at": {
+                    "type": "number"
+                  },
+                  "created_at": {
+                    "type": "number"
+                  }
+                },
+                "required": [
+                  "id",
+                  "account",
+                  "industry",
+                  "collected_at",
+                  "created_at"
+                ],
+                "additionalProperties": false
+              }
+            }
+          },
+          "required": [
+            "action",
+            "snapshots"
+          ],
+          "additionalProperties": false
+        }
+      ]
+    }
+  },
+  "required": [
+    "result"
+  ],
+  "additionalProperties": false
+}

package/dist/schemas/strategy_review_operation.schema.json

@@ -0,0 +1,66 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://wowok.net/schemas/strategy_review_operation.json",
+  "title": "Strategy Review - Posture-Weighted Scorecard & Periodic Review",
+  "description": "Evidence-driven operating review for one merchant account in one industry. Actions: collect (gather evidence across 6 sources, persist one append-only local snapshot), review (fresh evidence without persisting; posture-weighted 0-100 score, period deltas, deterministic pricing/posture recommendations, cadence, <=2 current-layer persona proposals that are only applied via explicit persona_operation apply), list_snapshots (stored history).",
+  "type": "object",
+  "properties": {
+    "action": {
+      "type": "string",
+      "enum": [
+        "collect",
+        "review",
+        "list_snapshots"
+      ],
+      "description": "collect = gather fresh on-chain/derived evidence, persist ONE local snapshot (append-only SQLite KV), return the raw collection; review = gather fresh evidence WITHOUT persisting, diff against the latest stored snapshot, score under the persona posture and assemble findings/recommendations/current-layer proposals (proposals are never auto-applied); list_snapshots = list stored snapshot summaries for account+industry."
+    },
+    "account": {
+      "type": "string",
+      "description": "Chain account address. Required for every action (scope of evidence and snapshots)."
+    },
+    "industry": {
+      "type": "string",
+      "description": "Industry id (e.g. education, rental, freelance, subscription, travel, retail, or a pack-registered id). Required for every action."
+    },
+    "posture": {
+      "description": "Override the scoring posture. Defaults to the merchant posture in the effective persona, then 'balanced'.",
+      "type": "string",
+      "enum": [
+        "volume",
+        "balanced",
+        "margin"
+      ]
+    },
+    "network": {
+      "description": "Network for evidence queries (default testnet).",
+      "type": "string",
+      "enum": [
+        "mainnet",
+        "testnet"
+      ]
+    },
+    "limit": {
+      "description": "Max records per evidence query (default follows the fetchers).",
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 200
+    },
+    "no_cache": {
+      "description": "Bypass caches in evidence fetchers.",
+      "type": "boolean"
+    },
+    "discovery_terms": {
+      "description": "Override discovery search terms for service/competitor enumeration (default: built-in bilingual terms for the industry).",
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    }
+  },
+  "required": [
+    "action",
+    "account",
+    "industry"
+  ],
+  "additionalProperties": false
+}