@wowok/agent-mcp 2.7.0 → 2.7.2

package/dist/knowledge/contact-risk.js

@@ -1,200 +1 @@
-import { MAX_IM_COUNT } from "@wowok/wowok";
-const R_C_01 = {
-    rule: {
-        id: "R-CONTACT-01",
-        level: "MEDIUM",
-        category: "permission",
-        title: "change_status has no permission check — IM list pollution risk",
-        description: "change_status lets any IM member self-update their status string without Permission " +
-            "verification (contact.move:32-43). If an attacker's address is added to the ims list " +
-            "(via im_add, which requires permission index 453), the attacker can freely pollute " +
-            "their status field (e.g. set status to 'fraud'). The risk is bounded by the im_add " +
-            "permission gate, but a misconfigured Permission could expose the IM list.",
-        affected_stakeholders: ["creator", "im_member"],
-        scenario: "Contact's IM list is misconfigured to allow public adds; attacker pollutes status",
-        mitigation: "Restrict permission index 453 (CONTACT_IM) to trusted guardians. Audit the IM list " +
-            "periodically. Business layer may validate status strings against an allowlist.",
-        auto_fixable: false,
-    },
-    check: (ctx) => {
-        if (!ctx.change_status_no_permission)
-            return null;
-        return { ...R_C_01.rule, evidence: "change_status_no_permission=true" };
-    },
-};
-const R_C_02 = {
-    rule: {
-        id: "R-CONTACT-02",
-        level: "LOW",
-        category: "structural",
-        title: `MAX_IM_COUNT=${MAX_IM_COUNT} is permissive — on-chain storage cost`,
-        description: `A single Contact may hold up to MAX_IM_COUNT=${MAX_IM_COUNT} IM entries (contact.move:14). ` +
-            `Aborting with E_IM_COUNT_EXCEEDED (1) only triggers at the boundary. 200 entries is ` +
-            `relatively permissive for a social scenario; loading the full list on every read ` +
-            `increases gas and storage cost.`,
-        affected_stakeholders: ["creator"],
-        scenario: "Caller adds 200 IM entries to a single Contact",
-        mitigation: "Business layer should self-limit IM count well below 200. For high-volume contact " +
-            "lists, shard across multiple Contact objects and aggregate off-chain.",
-        related_move_error: "E_IM_COUNT_EXCEEDED (1)",
-        auto_fixable: false,
-    },
-    check: (ctx) => {
-        if (ctx.im_count === undefined)
-            return null;
-        if (ctx.im_count < MAX_IM_COUNT)
-            return null;
-        return { ...R_C_02.rule, evidence: `im_count=${ctx.im_count}, limit=${MAX_IM_COUNT}` };
-    },
-};
-const R_C_03 = {
-    rule: {
-        id: "R-CONTACT-03",
-        level: "MEDIUM",
-        category: "semantic",
-        title: "IM list mutations emit no events — external indexers must poll",
-        description: "im_add / im_remove / im_clear do not emit events (contact.move:70-100). External " +
-            "indexers and notification systems cannot rely on event streams to track IM list " +
-            "changes; they must poll the ims field directly, increasing latency and RPC cost.",
-        affected_stakeholders: ["creator", "consumer"],
-        scenario: "Indexer expects an event on im_add but none is emitted; UI fails to refresh",
-        mitigation: "External indexers should poll the Contact.ims field on a cadence. A future version " +
-            "may add IMEvent; until then, do not build critical UX on IM event streams.",
-        auto_fixable: false,
-    },
-    check: (ctx) => null,
-};
-const R_C_04 = {
-    rule: {
-        id: "R-CONTACT-04",
-        level: "LOW",
-        category: "semantic",
-        title: "location defaults to empty string — may be misread as 'unset'",
-        description: "A freshly created Contact has location=\"\" (empty String). The Move type does not " +
-            "distinguish 'unset' from 'empty', so consumers may misinterpret an empty location " +
-            "as 'globally applicable' or as 'missing data'.",
-        affected_stakeholders: ["creator", "consumer"],
-        scenario: "Consumer reads location=\"\" and treats the Contact as global when it was never set",
-        mitigation: "Document that empty location means 'not specified'. If a default region is required, " +
-            "set location explicitly at creation time.",
-        auto_fixable: true,
-    },
-    check: (ctx) => {
-        if (!ctx.location_empty)
-            return null;
-        return { ...R_C_04.rule, evidence: "location=\"\" (empty, default)" };
-    },
-};
-const R_C_05 = {
-    rule: {
-        id: "R-CONTACT-05",
-        level: "MEDIUM",
-        category: "lifecycle",
-        title: "my_status silently fails for non-IM-members",
-        description: "my_status only updates the caller's status entry if the caller is in the ims list " +
-            "(contact.move:35-42). For a non-IM-member, the call silently succeeds without any " +
-            "state change — there is no abort and no event. Users get no feedback, making it " +
-            "impossible to distinguish 'status updated' from 'operation ignored'.",
-        affected_stakeholders: ["im_member"],
-        scenario: "Non-IM-member calls my_status expecting an error; operation is silently ignored",
-        mitigation: "SDK layer should pre-validate IM membership before submitting my_status and return a " +
-            "clear error. UI should show 'not an IM member' instead of 'success'.",
-        auto_fixable: false,
-    },
-    check: (ctx) => {
-        if (!ctx.my_status_from_non_member)
-            return null;
-        return { ...R_C_05.rule, evidence: "my_status_from_non_member=true (will be silently ignored)" };
-    },
-};
-const R_C_06 = {
-    rule: {
-        id: "R-CONTACT-06",
-        level: "LOW",
-        category: "semantic",
-        title: "im_add description uses LONG_NAME (not DESCRIPTION) — different length cap",
-        description: "im_add's description parameter is validated with common::LONG_NAME rather than " +
-            "common::DESCRIPTION (contact.move:70-86). The two validators have different length " +
-            "limits; callers expecting DESCRIPTION semantics may submit overly long strings and " +
-            "hit an unexpected abort.",
-        affected_stakeholders: ["creator"],
-        scenario: "Caller submits an im_add description sized for DESCRIPTION but hits LONG_NAME limit",
-        mitigation: "Document that im_add description uses LONG_NAME validation. SDK should expose the " +
-            "exact limit so callers size their strings correctly.",
-        auto_fixable: false,
-    },
-    check: (ctx) => {
-        if (!ctx.im_add_description_uses_long_name)
-            return null;
-        return { ...R_C_06.rule, evidence: "im_add description validated with LONG_NAME" };
-    },
-};
-const R_C_07 = {
-    rule: {
-        id: "R-CONTACT-07",
-        level: "MEDIUM",
-        category: "cross_object",
-        title: "permission_um_set creates Contact ↔ Permission bidirectional dependency",
-        description: "When Contact is set as a Permission's um via permission_um_set (contact.move:207-209), " +
-            "a bidirectional dependency forms: Permission.um → Contact, and Contact.permission → " +
-            "Permission. Deleting the Contact without first clearing the um reference leaves a " +
-            "dangling pointer in Permission.um.",
-        affected_stakeholders: ["creator", "consumer"],
-        scenario: "Contact is deleted while still bound as Permission.um; Permission.um becomes dangling",
-        mitigation: "Document the deletion order: (1) clear Permission.um via permission_um_set(null) " +
-            "first, (2) then delete the Contact. SDK should refuse to delete a Contact that is " +
-            "still bound as a um.",
-        auto_fixable: false,
-    },
-    check: (ctx) => {
-        if (!ctx.bound_to_permission_um)
-            return null;
-        return { ...R_C_07.rule, evidence: "bound_to_permission_um=true (deletion requires unbinding)" };
-    },
-};
-const R_C_08 = {
-    rule: {
-        id: "R-CONTACT-08",
-        level: "LOW",
-        category: "knowledge",
-        title: "Knowledge layer & constant sync — RESOLVED",
-        description: `MAX_IM_COUNT is now synced to onchain-constants.ts (${MAX_IM_COUNT}). The MCP ` +
-            `Knowledge layer now includes contact-risk.ts. This risk rule is retained for ` +
-            `historical audit and to detect future regressions.`,
-        affected_stakeholders: ["system"],
-        scenario: "Future regression: someone removes MAX_IM_COUNT from onchain-constants.ts",
-        mitigation: "Run the onchain-constants sync test to detect drift.",
-        auto_fixable: false,
-    },
-    check: (ctx) => {
-        if (ctx.constants_synced)
-            return null;
-        return { ...R_C_08.rule, evidence: "constants_synced=false" };
-    },
-};
-export const CONTACT_RISK_RULES = [
-    R_C_01,
-    R_C_02,
-    R_C_03,
-    R_C_04,
-    R_C_05,
-    R_C_06,
-    R_C_07,
-    R_C_08,
-];
-export const CONTACT_RISK_VERSION = "1.0.0";
-export function checkContactRisks(ctx) {
-    const risks = [];
-    for (const rule of CONTACT_RISK_RULES) {
-        const r = rule.check(ctx);
-        if (r)
-            risks.push(r);
-    }
-    if (!risks.find(r => r.id === "R-CONTACT-03")) {
-        risks.push(R_C_03.rule);
-    }
-    return risks;
-}
-export function getContactRiskById(id) {
-    return CONTACT_RISK_RULES.find(r => r.rule.id === id)?.rule;
-}
+import{MAX_IM_COUNT}from'@wowok/wowok';const R_C_01={'rule':{'id':'R-CONTACT-01','level':'MEDIUM','category':'permission','title':'change_status\x20has\x20no\x20permission\x20check\x20—\x20IM\x20list\x20pollution\x20risk','description':'change_status\x20lets\x20any\x20IM\x20member\x20self-update\x20their\x20status\x20string\x20without\x20Permission\x20'+'verification\x20(contact.move:32-43).\x20If\x20an\x20attacker\x27s\x20address\x20is\x20added\x20to\x20the\x20ims\x20list\x20'+'(via\x20im_add,\x20which\x20requires\x20permission\x20index\x20453),\x20the\x20attacker\x20can\x20freely\x20pollute\x20'+'their\x20status\x20field\x20(e.g.\x20set\x20status\x20to\x20\x27fraud\x27).\x20The\x20risk\x20is\x20bounded\x20by\x20the\x20im_add\x20'+'permission\x20gate,\x20but\x20a\x20misconfigured\x20Permission\x20could\x20expose\x20the\x20IM\x20list.','affected_stakeholders':['creator','im_member'],'scenario':'Contact\x27s\x20IM\x20list\x20is\x20misconfigured\x20to\x20allow\x20public\x20adds;\x20attacker\x20pollutes\x20status','mitigation':'Restrict\x20permission\x20index\x20453\x20(CONTACT_IM)\x20to\x20trusted\x20guardians.\x20Audit\x20the\x20IM\x20list\x20'+'periodically.\x20Business\x20layer\x20may\x20validate\x20status\x20strings\x20against\x20an\x20allowlist.','auto_fixable':![]},'check':a=>{if(!a['change_status_no_permission'])return null;return{...R_C_01['rule'],'evidence':'change_status_no_permission=true'};}},R_C_02={'rule':{'id':'R-CONTACT-02','level':'LOW','category':'structural','title':'MAX_IM_COUNT='+MAX_IM_COUNT+'\x20is\x20permissive\x20—\x20on-chain\x20storage\x20cost','description':'A\x20single\x20Contact\x20may\x20hold\x20up\x20to\x20MAX_IM_COUNT='+MAX_IM_COUNT+'\x20IM\x20entries\x20(contact.move:14).\x20'+'Aborting\x20with\x20E_IM_COUNT_EXCEEDED\x20(1)\x20only\x20triggers\x20at\x20the\x20boundary.\x20200\x20entries\x20is\x20'+'relatively\x20permissive\x20for\x20a\x20social\x20scenario;\x20loading\x20the\x20full\x20list\x20on\x20every\x20read\x20'+'increases\x20gas\x20and\x20storage\x20cost.','affected_stakeholders':['creator'],'scenario':'Caller\x20adds\x20200\x20IM\x20entries\x20to\x20a\x20single\x20Contact','mitigation':'Business\x20layer\x20should\x20self-limit\x20IM\x20count\x20well\x20below\x20200.\x20For\x20high-volume\x20contact\x20'+'lists,\x20shard\x20across\x20multiple\x20Contact\x20objects\x20and\x20aggregate\x20off-chain.','related_move_error':'E_IM_COUNT_EXCEEDED\x20(1)','auto_fixable':![]},'check':a=>{if(a['im_count']===undefined)return null;if(a['im_count']<MAX_IM_COUNT)return null;return{...R_C_02['rule'],'evidence':'im_count='+a['im_count']+',\x20limit='+MAX_IM_COUNT};}},R_C_03={'rule':{'id':'R-CONTACT-03','level':'MEDIUM','category':'semantic','title':'IM\x20list\x20mutations\x20emit\x20no\x20events\x20—\x20external\x20indexers\x20must\x20poll','description':'im_add\x20/\x20im_remove\x20/\x20im_clear\x20do\x20not\x20emit\x20events\x20(contact.move:70-100).\x20External\x20'+'indexers\x20and\x20notification\x20systems\x20cannot\x20rely\x20on\x20event\x20streams\x20to\x20track\x20IM\x20list\x20'+'changes;\x20they\x20must\x20poll\x20the\x20ims\x20field\x20directly,\x20increasing\x20latency\x20and\x20RPC\x20cost.','affected_stakeholders':['creator','consumer'],'scenario':'Indexer\x20expects\x20an\x20event\x20on\x20im_add\x20but\x20none\x20is\x20emitted;\x20UI\x20fails\x20to\x20refresh','mitigation':'External\x20indexers\x20should\x20poll\x20the\x20Contact.ims\x20field\x20on\x20a\x20cadence.\x20A\x20future\x20version\x20'+'may\x20add\x20IMEvent;\x20until\x20then,\x20do\x20not\x20build\x20critical\x20UX\x20on\x20IM\x20event\x20streams.','auto_fixable':![]},'check':a=>null},R_C_04={'rule':{'id':'R-CONTACT-04','level':'LOW','category':'semantic','title':'location\x20defaults\x20to\x20empty\x20string\x20—\x20may\x20be\x20misread\x20as\x20\x27unset\x27','description':'A\x20freshly\x20created\x20Contact\x20has\x20location=\x22\x22\x20(empty\x20String).\x20The\x20Move\x20type\x20does\x20not\x20'+'distinguish\x20\x27unset\x27\x20from\x20\x27empty\x27,\x20so\x20consumers\x20may\x20misinterpret\x20an\x20empty\x20location\x20'+'as\x20\x27globally\x20applicable\x27\x20or\x20as\x20\x27missing\x20data\x27.','affected_stakeholders':['creator','consumer'],'scenario':'Consumer\x20reads\x20location=\x22\x22\x20and\x20treats\x20the\x20Contact\x20as\x20global\x20when\x20it\x20was\x20never\x20set','mitigation':'Document\x20that\x20empty\x20location\x20means\x20\x27not\x20specified\x27.\x20If\x20a\x20default\x20region\x20is\x20required,\x20'+'set\x20location\x20explicitly\x20at\x20creation\x20time.','auto_fixable':!![]},'check':a=>{if(!a['location_empty'])return null;return{...R_C_04['rule'],'evidence':'location=\x22\x22\x20(empty,\x20default)'};}},R_C_05={'rule':{'id':'R-CONTACT-05','level':'MEDIUM','category':'lifecycle','title':'my_status\x20silently\x20fails\x20for\x20non-IM-members','description':'my_status\x20only\x20updates\x20the\x20caller\x27s\x20status\x20entry\x20if\x20the\x20caller\x20is\x20in\x20the\x20ims\x20list\x20'+'(contact.move:35-42).\x20For\x20a\x20non-IM-member,\x20the\x20call\x20silently\x20succeeds\x20without\x20any\x20'+'state\x20change\x20—\x20there\x20is\x20no\x20abort\x20and\x20no\x20event.\x20Users\x20get\x20no\x20feedback,\x20making\x20it\x20'+'impossible\x20to\x20distinguish\x20\x27status\x20updated\x27\x20from\x20\x27operation\x20ignored\x27.','affected_stakeholders':['im_member'],'scenario':'Non-IM-member\x20calls\x20my_status\x20expecting\x20an\x20error;\x20operation\x20is\x20silently\x20ignored','mitigation':'SDK\x20layer\x20should\x20pre-validate\x20IM\x20membership\x20before\x20submitting\x20my_status\x20and\x20return\x20a\x20'+'clear\x20error.\x20UI\x20should\x20show\x20\x27not\x20an\x20IM\x20member\x27\x20instead\x20of\x20\x27success\x27.','auto_fixable':![]},'check':a=>{if(!a['my_status_from_non_member'])return null;return{...R_C_05['rule'],'evidence':'my_status_from_non_member=true\x20(will\x20be\x20silently\x20ignored)'};}},R_C_06={'rule':{'id':'R-CONTACT-06','level':'LOW','category':'semantic','title':'im_add\x20description\x20uses\x20LONG_NAME\x20(not\x20DESCRIPTION)\x20—\x20different\x20length\x20cap','description':'im_add\x27s\x20description\x20parameter\x20is\x20validated\x20with\x20common::LONG_NAME\x20rather\x20than\x20'+'common::DESCRIPTION\x20(contact.move:70-86).\x20The\x20two\x20validators\x20have\x20different\x20length\x20'+'limits;\x20callers\x20expecting\x20DESCRIPTION\x20semantics\x20may\x20submit\x20overly\x20long\x20strings\x20and\x20'+'hit\x20an\x20unexpected\x20abort.','affected_stakeholders':['creator'],'scenario':'Caller\x20submits\x20an\x20im_add\x20description\x20sized\x20for\x20DESCRIPTION\x20but\x20hits\x20LONG_NAME\x20limit','mitigation':'Document\x20that\x20im_add\x20description\x20uses\x20LONG_NAME\x20validation.\x20SDK\x20should\x20expose\x20the\x20'+'exact\x20limit\x20so\x20callers\x20size\x20their\x20strings\x20correctly.','auto_fixable':![]},'check':a=>{if(!a['im_add_description_uses_long_name'])return null;return{...R_C_06['rule'],'evidence':'im_add\x20description\x20validated\x20with\x20LONG_NAME'};}},R_C_07={'rule':{'id':'R-CONTACT-07','level':'MEDIUM','category':'cross_object','title':'permission_um_set\x20creates\x20Contact\x20↔\x20Permission\x20bidirectional\x20dependency','description':'When\x20Contact\x20is\x20set\x20as\x20a\x20Permission\x27s\x20um\x20via\x20permission_um_set\x20(contact.move:207-209),\x20'+'a\x20bidirectional\x20dependency\x20forms:\x20Permission.um\x20→\x20Contact,\x20and\x20Contact.permission\x20→\x20'+'Permission.\x20Deleting\x20the\x20Contact\x20without\x20first\x20clearing\x20the\x20um\x20reference\x20leaves\x20a\x20'+'dangling\x20pointer\x20in\x20Permission.um.','affected_stakeholders':['creator','consumer'],'scenario':'Contact\x20is\x20deleted\x20while\x20still\x20bound\x20as\x20Permission.um;\x20Permission.um\x20becomes\x20dangling','mitigation':'Document\x20the\x20deletion\x20order:\x20(1)\x20clear\x20Permission.um\x20via\x20permission_um_set(null)\x20'+'first,\x20(2)\x20then\x20delete\x20the\x20Contact.\x20SDK\x20should\x20refuse\x20to\x20delete\x20a\x20Contact\x20that\x20is\x20'+'still\x20bound\x20as\x20a\x20um.','auto_fixable':![]},'check':a=>{if(!a['bound_to_permission_um'])return null;return{...R_C_07['rule'],'evidence':'bound_to_permission_um=true\x20(deletion\x20requires\x20unbinding)'};}},R_C_08={'rule':{'id':'R-CONTACT-08','level':'LOW','category':'knowledge','title':'Knowledge\x20layer\x20&\x20constant\x20sync\x20—\x20RESOLVED','description':'MAX_IM_COUNT\x20is\x20now\x20synced\x20to\x20onchain-constants.ts\x20('+MAX_IM_COUNT+').\x20The\x20MCP\x20'+'Knowledge\x20layer\x20now\x20includes\x20contact-risk.ts.\x20This\x20risk\x20rule\x20is\x20retained\x20for\x20'+'historical\x20audit\x20and\x20to\x20detect\x20future\x20regressions.','affected_stakeholders':['system'],'scenario':'Future\x20regression:\x20someone\x20removes\x20MAX_IM_COUNT\x20from\x20onchain-constants.ts','mitigation':'Run\x20the\x20onchain-constants\x20sync\x20test\x20to\x20detect\x20drift.','auto_fixable':![]},'check':a=>{if(a['constants_synced'])return null;return{...R_C_08['rule'],'evidence':'constants_synced=false'};}};export const CONTACT_RISK_RULES=[R_C_01,R_C_02,R_C_03,R_C_04,R_C_05,R_C_06,R_C_07,R_C_08];export const CONTACT_RISK_VERSION='1.0.0';export function checkContactRisks(a){const b=[];for(const c of CONTACT_RISK_RULES){const d=c['check'](a);if(d)b['push'](d);}return!b['find'](e=>e['id']==='R-CONTACT-03')&&b['push'](R_C_03['rule']),b;}export function getContactRiskById(a){return CONTACT_RISK_RULES['find'](b=>b['rule']['id']===a)?.['rule'];}

package/dist/knowledge/contact-templates.d.ts

@@ -0,0 +1,27 @@
+export type ContactTemplateParamType = "string";
+export interface ContactTemplateParam {
+    name: string;
+    type: ContactTemplateParamType;
+    description: string;
+    required: boolean;
+}
+export interface ContactTemplate {
+    id: string;
+    name: string;
+    description: string;
+    applicable_scenes: string[];
+    industry_tags: string[];
+    params: ContactTemplateParam[];
+    body: (params: Record<string, string>) => object;
+    notes?: string[];
+}
+export declare const CONTACT_TEMPLATES: ContactTemplate[];
+export declare const CONTACT_TEMPLATES_VERSION = "1.0.0";
+export declare function getContactTemplateById(id: string): ContactTemplate | undefined;
+export declare function fillTemplate(templateId: string, params: Record<string, string>): {
+    ok: true;
+    body: object;
+} | {
+    ok: false;
+    error: string;
+};

package/dist/knowledge/contact-templates.js

@@ -0,0 +1 @@
+export const CONTACT_TEMPLATES=[{'id':'T-C-01','name':'Basic\x20contact','description':'Named\x20contact\x20with\x20a\x20permission\x20reference\x20and\x20description.\x20Bind\x20to\x20a\x20Service\x20via\x20`um`.','applicable_scenes':['contact_basic'],'industry_tags':['universal'],'params':[{'name':'name','type':'string','description':'Contact\x20object\x20name','required':!![]},{'name':'permission','type':'string','description':'Permission\x20object\x20name/address','required':!![]},{'name':'description','type':'string','description':'Contact\x20description\x20shown\x20to\x20customers','required':!![]}],'body':a=>({'object':{'name':a['name'],'permission':a['permission'],'replaceExistName':!![]},'description':a['description']}),'notes':['Bind\x20this\x20contact\x20to\x20a\x20Service\x20via\x20the\x20service\x20call\x27s\x20\x27um\x27\x20field']},{'id':'T-C-02','name':'Support\x20contact\x20with\x20IM','description':'Contact\x20with\x20an\x20initial\x20IM\x20entry\x20pointing\x20at\x20a\x20support\x20account\x20(after-sales\x20/\x20pre-order).','applicable_scenes':['contact_support'],'industry_tags':['retail','rental','education','travel','freelance','subscription'],'params':[{'name':'name','type':'string','description':'Contact\x20object\x20name','required':!![]},{'name':'permission','type':'string','description':'Permission\x20object\x20name/address','required':!![]},{'name':'description','type':'string','description':'Contact\x20description\x20shown\x20to\x20customers','required':!![]},{'name':'support_account','type':'string','description':'Support\x20account\x20name\x20or\x200x\x20address\x20for\x20IM','required':!![]},{'name':'im_description','type':'string','description':'IM\x20entry\x20description\x20(e.g.\x20\x27Primary\x20support\x20representative\x27)','required':!![]}],'body':a=>({'object':{'name':a['name'],'permission':a['permission'],'replaceExistName':!![]},'description':a['description'],'ims':{'op':'add','im':[{'at':a['support_account'],'description':a['im_description']}]}}),'notes':['ims.im[].at\x20accepts\x20an\x20account\x20name\x20or\x20a\x20full\x200x\x20address','ims\x20is\x20an\x20op\x20discriminated\x20union\x20—\x20{op:\x27add\x27|\x27set\x27|\x27remove\x27|\x27clear\x27}']}];export const CONTACT_TEMPLATES_VERSION='1.0.0';export function getContactTemplateById(a){return CONTACT_TEMPLATES['find'](b=>b['id']===a);}export function fillTemplate(a,b){const c=getContactTemplateById(a);if(!c)return{'ok':![],'error':'Template\x20'+a+'\x20not\x20found'};for(const d of c['params']){if(d['required']&&!(d['name']in b))return{'ok':![],'error':'Missing\x20required\x20param:\x20'+d['name']};}return{'ok':!![],'body':c['body'](b)};}

package/dist/knowledge/demand-confirm.js

@@ -1,206 +1 @@
-import { MAX_REWARD_COUNT, MAX_GUARD_COUNT_DEMAND, MAX_DESCRIPTION_LENGTH, MAX_LONG_NAME_LENGTH, } from "@wowok/wowok";
-const MAX_FEEDBACK_COUNT = 20;
-function checkDescription(input) {
-    const len = input.description?.length ?? 0;
-    const passed = len > 0 && len <= MAX_DESCRIPTION_LENGTH;
-    return {
-        id: "C-DEM-01",
-        severity: passed ? "info" : (len === 0 ? "warn" : "block"),
-        title: `description non-empty and within MAX_DESCRIPTION_LENGTH (${MAX_DESCRIPTION_LENGTH} chars)`,
-        description: "description is a REQUIRED field. Move contract validates via common::DESCRIPTION (demand.move:157,177). " +
-            "Empty string is technically rejected by common::DESCRIPTION only if NAME_ALLOW_EMPTY is not used; the new_imp " +
-            "path uses common::DESCRIPTION which allows empty but enforces the 4000-char limit. Non-empty descriptions are " +
-            "strongly recommended for Demand discoverability.",
-        passed,
-        evidence: input.description === undefined ? "undefined" : `length=${len}, limit=${MAX_DESCRIPTION_LENGTH}`,
-        fix_hint: passed ? undefined : `Provide a description of 1..${MAX_DESCRIPTION_LENGTH} characters.`,
-    };
-}
-function checkLocation(input) {
-    const len = input.location?.length ?? 0;
-    const passed = len <= MAX_LONG_NAME_LENGTH;
-    return {
-        id: "C-DEM-02",
-        severity: passed ? "info" : "block",
-        title: `location within MAX_LONG_NAME_LENGTH (${MAX_LONG_NAME_LENGTH} chars)`,
-        description: "location is set via location_set_imp (demand.move:179-182) which validates via common::LONG_NAME. " +
-            "Move aborts with E_LONG_NAME_LENGTH_EXCEEDED (11) on overflow. Empty location (\"\") is valid — new_imp " +
-            "initializes location to empty string. Use location_set to update after creation.",
-        passed,
-        evidence: input.location === undefined ? "undefined" : `length=${len}, limit=${MAX_LONG_NAME_LENGTH}`,
-        fix_hint: passed ? undefined : `Trim location to ≤ ${MAX_LONG_NAME_LENGTH} characters.`,
-    };
-}
-function checkRewards(input) {
-    const count = input.rewards?.length ?? 0;
-    const passed = count <= MAX_REWARD_COUNT;
-    return {
-        id: "C-DEM-03",
-        severity: passed ? "info" : "block",
-        title: `rewards count within MAX_REWARD_COUNT (${MAX_REWARD_COUNT})`,
-        description: "Each reward_add_imp (demand.move:184-191) checks `vector::length(&self.rewards) < MAX_REWARD_COUNT` " +
-            "before pushing (after de-duplication). Move aborts with E_MAX_REWARD_COUNT_EXCEEDED (1) on overflow. " +
-            "Rewards are affiliated via the Registrar — adding/removing triggers affiliation/disaffiliation.",
-        passed,
-        evidence: `count=${count}, limit=${MAX_REWARD_COUNT}`,
-        fix_hint: passed ? undefined : `Remove rewards before adding new ones. Limit=${MAX_REWARD_COUNT}.`,
-    };
-}
-function checkGuards(input) {
-    const count = input.guards?.length ?? 0;
-    const passed = count <= MAX_GUARD_COUNT_DEMAND;
-    return {
-        id: "C-DEM-04",
-        severity: passed ? "info" : "block",
-        title: `guards count within MAX_GUARD_COUNT_DEMAND (${MAX_GUARD_COUNT_DEMAND})`,
-        description: "Each guard_add_imp (demand.move:213-242) checks `vector::length(&self.guards) < MAX_GUARD_COUNT` " +
-            "before pushing (after duplicate check — duplicates update service_identifier in place). " +
-            "Move aborts with E_MAX_GUARD_COUNT_EXCEEDED (2) on overflow. Guards are affiliated via the Registrar.",
-        passed,
-        evidence: `count=${count}, limit=${MAX_GUARD_COUNT_DEMAND}`,
-        fix_hint: passed ? undefined : `Remove guards before adding new ones. Limit=${MAX_GUARD_COUNT_DEMAND}.`,
-    };
-}
-function checkFeedback(input) {
-    const count = input.feedback?.length ?? 0;
-    const passed = count <= MAX_FEEDBACK_COUNT;
-    return {
-        id: "C-DEM-05",
-        severity: passed ? "info" : "block",
-        title: `feedback batch count within MAX_FEEDBACK_COUNT (${MAX_FEEDBACK_COUNT})`,
-        description: "Move feedback (demand.move:352) updates ONE presenter per call — feedback_imp writes to a single " +
-            "ServiceInfo record. The SDK batches multiple feedback calls and caps the batch at MAX_FEEDBACK_COUNT=" +
-            `${MAX_FEEDBACK_COUNT} (SDK-only limit, NOT in onchain-constants.ts). Exceeding the SDK batch limit is ` +
-            "rejected before transaction building. Each feedback string is validated by common::DESCRIPTION (4000 chars).",
-        passed,
-        evidence: `count=${count}, limit=${MAX_FEEDBACK_COUNT}`,
-        fix_hint: passed ? undefined : `Split feedback into batches of ≤ ${MAX_FEEDBACK_COUNT} entries.`,
-    };
-}
-function checkServiceIdentifier(input) {
-    const sid = input.service_identifier;
-    if (sid === null || sid === undefined) {
-        return {
-            id: "C-DEM-06",
-            severity: "info",
-            title: "service_identifier is null/undefined → Option::none (use supplied service address)",
-            description: "When service_identifier is None, guard_add_imp stores Option::none in ServiceGuard. At present_with_passport " +
-                "time, present_with_passport_imp uses the service parameter (or Option::none for plain present_with_passport). " +
-                "Use None when the Demand does not need to route presentations through a specific Service submission.",
-            passed: true,
-            evidence: "null/undefined → Option::none",
-        };
-    }
-    const isU8 = typeof sid === "number" && Number.isInteger(sid) && sid >= 0 && sid <= 255;
-    return {
-        id: "C-DEM-06",
-        severity: isU8 ? "info" : "block",
-        title: "service_identifier is a valid u8 (0-255) when provided",
-        description: "When provided, service_identifier must be a u8 index into the Guard's submission registry. " +
-            "guard_add_imp (demand.move:218-222) calls guard::get_submission_object_type(guard, *i) and " +
-            "common::assert_service_object_type(t) — the submission at that index MUST exist and have type " +
-            "ObjectType::Service. At present_with_passport time, the submission address is extracted from the Passport " +
-            "via passport::submission_get(passport, &g, *service_identifier).",
-        passed: isU8,
-        evidence: `service_identifier=${sid}`,
-        fix_hint: isU8 ? undefined : "Provide an integer in [0, 255] that indexes a Service-typed submission in the Guard.",
-    };
-}
-function checkByGuard(input) {
-    const byGuard = input.by_guard;
-    if (byGuard === null || byGuard === undefined) {
-        return {
-            id: "C-DEM-07",
-            severity: "info",
-            title: "by_guard is null → use plain present (requires empty guards vector)",
-            description: "When by_guard is None, the caller uses plain present (demand.move:100) which asserts " +
-                "`vector::is_empty(&self.guards)` — aborts with E_NEED_PASSPORT (3) if guards exist. Use this path " +
-                "for open Demands (no guards).",
-            passed: true,
-            evidence: "null/undefined → plain present path",
-        };
-    }
-    if (input.guards === undefined) {
-        return {
-            id: "C-DEM-07",
-            severity: "info",
-            title: "by_guard provided (cannot verify membership — guards list not supplied)",
-            description: "present_with_passport_imp (demand.move:110-129) iterates the guards vector looking for a matching " +
-                "guard address. If not found, it aborts with E_GUARD_NOT_FOUND (4). The caller must ensure by_guard " +
-                "is in Demand.guards — this check could not verify because the guards list was not supplied.",
-            passed: true,
-            evidence: `by_guard=${byGuard.substring(0, 10)}... (guards list not supplied)`,
-            fix_hint: "Pass input.guards to enable membership verification.",
-        };
-    }
-    const isInGuards = input.guards.includes(byGuard);
-    return {
-        id: "C-DEM-07",
-        severity: isInGuards ? "info" : "block",
-        title: "by_guard exists in Demand.guards (when specified)",
-        description: "When by_guard is specified, present_with_passport_imp (demand.move:110-129) iterates the guards vector " +
-            "looking for a matching guard address. If not found, it aborts with E_GUARD_NOT_FOUND (4). The caller " +
-            "MUST ensure by_guard was previously added via guard_add.",
-        passed: isInGuards,
-        evidence: `by_guard=${byGuard.substring(0, 10)}..., in guards=${isInGuards}`,
-        fix_hint: isInGuards ? undefined : "Call guard_add(permission, guard, service_identifier) first.",
-    };
-}
-function checkPermissionSetAvailable(input) {
-    const available = input.permission_set_available !== false;
-    return {
-        id: "C-DEM-08",
-        severity: available ? "info" : "warn",
-        title: "permission_set available via CallPermission.apply (DE-D-2=A)",
-        description: "The Move permission_set function (demand.move:286) is exposed in the SDK via the CallPermission.apply " +
-            "mechanism (DE-D-2=A). It calls permission::assert_owner(old) and registrar::affiliation_change to migrate " +
-            "the affiliation. Permission indices for Demand (demand.move:20): 400=DEMAND_NEW, 401=DEMAND_DESCRIPTION, " +
-            "402=DEMAND_LOCATION, 404=DEMAND_GUARD, 405=DEMAND_REWARD, 406=DEMAND_FEEDBACK, 407=DEMAND_OWNER_RECEIVE, " +
-            "408=DEMAND_UM. This is an info check — it confirms the capability is available, not a creation prerequisite.",
-        passed: available,
-        evidence: available ? "exposed via CallPermission.apply" : "not available (regression)",
-        fix_hint: available ? undefined : "Restore the CallPermission.apply path for permission_set.",
-    };
-}
-export function preCheckDemandCreation(input) {
-    return [
-        checkDescription(input),
-        checkLocation(input),
-        checkRewards(input),
-        checkGuards(input),
-        checkFeedback(input),
-        checkServiceIdentifier(input),
-        checkByGuard(input),
-        checkPermissionSetAvailable(input),
-    ];
-}
-export function canCreateDemand(input) {
-    const items = preCheckDemandCreation(input);
-    return {
-        canCreate: items.every(i => i.severity !== "block" || i.passed),
-        blockers: items.filter(i => i.severity === "block" && !i.passed),
-        warnings: items.filter(i => i.severity === "warn" && !i.passed),
-        info: items.filter(i => i.severity === "info"),
-    };
-}
-export function formatDemandCreationSummary(input) {
-    const { canCreate, blockers, warnings, info } = canCreateDemand(input);
-    const lines = [];
-    lines.push(canCreate ? "✓ Demand pre-check PASSED" : "✗ Demand pre-check FAILED");
-    lines.push("");
-    if (blockers.length > 0) {
-        lines.push("BLOCKERS (must fix before operation):");
-        blockers.forEach(b => lines.push(`  [${b.id}] ${b.title} — ${b.evidence ?? ""}`));
-        lines.push("");
-    }
-    if (warnings.length > 0) {
-        lines.push("WARNINGS (review recommended):");
-        warnings.forEach(w => lines.push(`  [${w.id}] ${w.title} — ${w.evidence ?? ""}`));
-        lines.push("");
-    }
-    if (info.length > 0) {
-        lines.push("INFO:");
-        info.forEach(i => lines.push(`  [${i.id}] ${i.title}`));
-    }
-    return lines.join("\n");
-}
+import{MAX_REWARD_COUNT,MAX_GUARD_COUNT_DEMAND,MAX_DESCRIPTION_LENGTH,MAX_LONG_NAME_LENGTH}from'@wowok/wowok';const MAX_FEEDBACK_COUNT=0x14;function checkDescription(a){const b=a['description']?.['length']??0x0,c=b>0x0&&b<=MAX_DESCRIPTION_LENGTH;return{'id':'C-DEM-01','severity':c?'info':b===0x0?'warn':'block','title':'description\x20non-empty\x20and\x20within\x20MAX_DESCRIPTION_LENGTH\x20('+MAX_DESCRIPTION_LENGTH+'\x20chars)','description':'description\x20is\x20a\x20REQUIRED\x20field.\x20Move\x20contract\x20validates\x20via\x20common::DESCRIPTION\x20(demand.move:157,177).\x20'+'Empty\x20string\x20is\x20technically\x20rejected\x20by\x20common::DESCRIPTION\x20only\x20if\x20NAME_ALLOW_EMPTY\x20is\x20not\x20used;\x20the\x20new_imp\x20'+'path\x20uses\x20common::DESCRIPTION\x20which\x20allows\x20empty\x20but\x20enforces\x20the\x204000-char\x20limit.\x20Non-empty\x20descriptions\x20are\x20'+'strongly\x20recommended\x20for\x20Demand\x20discoverability.','passed':c,'evidence':a['description']===undefined?'undefined':'length='+b+',\x20limit='+MAX_DESCRIPTION_LENGTH,'fix_hint':c?undefined:'Provide\x20a\x20description\x20of\x201..'+MAX_DESCRIPTION_LENGTH+'\x20characters.'};}function checkLocation(a){const b=a['location']?.['length']??0x0,c=b<=MAX_LONG_NAME_LENGTH;return{'id':'C-DEM-02','severity':c?'info':'block','title':'location\x20within\x20MAX_LONG_NAME_LENGTH\x20('+MAX_LONG_NAME_LENGTH+'\x20chars)','description':'location\x20is\x20set\x20via\x20location_set_imp\x20(demand.move:179-182)\x20which\x20validates\x20via\x20common::LONG_NAME.\x20'+'Move\x20aborts\x20with\x20E_LONG_NAME_LENGTH_EXCEEDED\x20(11)\x20on\x20overflow.\x20Empty\x20location\x20(\x22\x22)\x20is\x20valid\x20—\x20new_imp\x20'+'initializes\x20location\x20to\x20empty\x20string.\x20Use\x20location_set\x20to\x20update\x20after\x20creation.','passed':c,'evidence':a['location']===undefined?'undefined':'length='+b+',\x20limit='+MAX_LONG_NAME_LENGTH,'fix_hint':c?undefined:'Trim\x20location\x20to\x20≤\x20'+MAX_LONG_NAME_LENGTH+'\x20characters.'};}function checkRewards(a){const b=a['rewards']?.['length']??0x0,c=b<=MAX_REWARD_COUNT;return{'id':'C-DEM-03','severity':c?'info':'block','title':'rewards\x20count\x20within\x20MAX_REWARD_COUNT\x20('+MAX_REWARD_COUNT+')','description':'Each\x20reward_add_imp\x20(demand.move:184-191)\x20checks\x20`vector::length(&self.rewards)\x20<\x20MAX_REWARD_COUNT`\x20'+'before\x20pushing\x20(after\x20de-duplication).\x20Move\x20aborts\x20with\x20E_MAX_REWARD_COUNT_EXCEEDED\x20(1)\x20on\x20overflow.\x20'+'Rewards\x20are\x20affiliated\x20via\x20the\x20Registrar\x20—\x20adding/removing\x20triggers\x20affiliation/disaffiliation.','passed':c,'evidence':'count='+b+',\x20limit='+MAX_REWARD_COUNT,'fix_hint':c?undefined:'Remove\x20rewards\x20before\x20adding\x20new\x20ones.\x20Limit='+MAX_REWARD_COUNT+'.'};}function checkGuards(a){const b=a['guards']?.['length']??0x0,c=b<=MAX_GUARD_COUNT_DEMAND;return{'id':'C-DEM-04','severity':c?'info':'block','title':'guards\x20count\x20within\x20MAX_GUARD_COUNT_DEMAND\x20('+MAX_GUARD_COUNT_DEMAND+')','description':'Each\x20guard_add_imp\x20(demand.move:213-242)\x20checks\x20`vector::length(&self.guards)\x20<\x20MAX_GUARD_COUNT`\x20'+'before\x20pushing\x20(after\x20duplicate\x20check\x20—\x20duplicates\x20update\x20service_identifier\x20in\x20place).\x20'+'Move\x20aborts\x20with\x20E_MAX_GUARD_COUNT_EXCEEDED\x20(2)\x20on\x20overflow.\x20Guards\x20are\x20affiliated\x20via\x20the\x20Registrar.','passed':c,'evidence':'count='+b+',\x20limit='+MAX_GUARD_COUNT_DEMAND,'fix_hint':c?undefined:'Remove\x20guards\x20before\x20adding\x20new\x20ones.\x20Limit='+MAX_GUARD_COUNT_DEMAND+'.'};}function checkFeedback(a){const b=a['feedback']?.['length']??0x0,c=b<=MAX_FEEDBACK_COUNT;return{'id':'C-DEM-05','severity':c?'info':'block','title':'feedback\x20batch\x20count\x20within\x20MAX_FEEDBACK_COUNT\x20('+MAX_FEEDBACK_COUNT+')','description':'Move\x20feedback\x20(demand.move:352)\x20updates\x20ONE\x20presenter\x20per\x20call\x20—\x20feedback_imp\x20writes\x20to\x20a\x20single\x20'+'ServiceInfo\x20record.\x20The\x20SDK\x20batches\x20multiple\x20feedback\x20calls\x20and\x20caps\x20the\x20batch\x20at\x20MAX_FEEDBACK_COUNT='+(MAX_FEEDBACK_COUNT+'\x20(SDK-only\x20limit,\x20NOT\x20in\x20onchain-constants.ts).\x20Exceeding\x20the\x20SDK\x20batch\x20limit\x20is\x20')+'rejected\x20before\x20transaction\x20building.\x20Each\x20feedback\x20string\x20is\x20validated\x20by\x20common::DESCRIPTION\x20(4000\x20chars).','passed':c,'evidence':'count='+b+',\x20limit='+MAX_FEEDBACK_COUNT,'fix_hint':c?undefined:'Split\x20feedback\x20into\x20batches\x20of\x20≤\x20'+MAX_FEEDBACK_COUNT+'\x20entries.'};}function checkServiceIdentifier(a){const b=a['service_identifier'];if(b===null||b===undefined)return{'id':'C-DEM-06','severity':'info','title':'service_identifier\x20is\x20null/undefined\x20→\x20Option::none\x20(use\x20supplied\x20service\x20address)','description':'When\x20service_identifier\x20is\x20None,\x20guard_add_imp\x20stores\x20Option::none\x20in\x20ServiceGuard.\x20At\x20present_with_passport\x20'+'time,\x20present_with_passport_imp\x20uses\x20the\x20service\x20parameter\x20(or\x20Option::none\x20for\x20plain\x20present_with_passport).\x20'+'Use\x20None\x20when\x20the\x20Demand\x20does\x20not\x20need\x20to\x20route\x20presentations\x20through\x20a\x20specific\x20Service\x20submission.','passed':!![],'evidence':'null/undefined\x20→\x20Option::none'};const c=typeof b==='number'&&Number['isInteger'](b)&&b>=0x0&&b<=0xff;return{'id':'C-DEM-06','severity':c?'info':'block','title':'service_identifier\x20is\x20a\x20valid\x20u8\x20(0-255)\x20when\x20provided','description':'When\x20provided,\x20service_identifier\x20must\x20be\x20a\x20u8\x20index\x20into\x20the\x20Guard\x27s\x20submission\x20registry.\x20'+'guard_add_imp\x20(demand.move:218-222)\x20calls\x20guard::get_submission_object_type(guard,\x20*i)\x20and\x20'+'common::assert_service_object_type(t)\x20—\x20the\x20submission\x20at\x20that\x20index\x20MUST\x20exist\x20and\x20have\x20type\x20'+'ObjectType::Service.\x20At\x20present_with_passport\x20time,\x20the\x20submission\x20address\x20is\x20extracted\x20from\x20the\x20Passport\x20'+'via\x20passport::submission_get(passport,\x20&g,\x20*service_identifier).','passed':c,'evidence':'service_identifier='+b,'fix_hint':c?undefined:'Provide\x20an\x20integer\x20in\x20[0,\x20255]\x20that\x20indexes\x20a\x20Service-typed\x20submission\x20in\x20the\x20Guard.'};}function checkByGuard(a){const b=a['by_guard'];if(b===null||b===undefined)return{'id':'C-DEM-07','severity':'info','title':'by_guard\x20is\x20null\x20→\x20use\x20plain\x20present\x20(requires\x20empty\x20guards\x20vector)','description':'When\x20by_guard\x20is\x20None,\x20the\x20caller\x20uses\x20plain\x20present\x20(demand.move:100)\x20which\x20asserts\x20'+'`vector::is_empty(&self.guards)`\x20—\x20aborts\x20with\x20E_NEED_PASSPORT\x20(3)\x20if\x20guards\x20exist.\x20Use\x20this\x20path\x20'+'for\x20open\x20Demands\x20(no\x20guards).','passed':!![],'evidence':'null/undefined\x20→\x20plain\x20present\x20path'};if(a['guards']===undefined)return{'id':'C-DEM-07','severity':'info','title':'by_guard\x20provided\x20(cannot\x20verify\x20membership\x20—\x20guards\x20list\x20not\x20supplied)','description':'present_with_passport_imp\x20(demand.move:110-129)\x20iterates\x20the\x20guards\x20vector\x20looking\x20for\x20a\x20matching\x20'+'guard\x20address.\x20If\x20not\x20found,\x20it\x20aborts\x20with\x20E_GUARD_NOT_FOUND\x20(4).\x20The\x20caller\x20must\x20ensure\x20by_guard\x20'+'is\x20in\x20Demand.guards\x20—\x20this\x20check\x20could\x20not\x20verify\x20because\x20the\x20guards\x20list\x20was\x20not\x20supplied.','passed':!![],'evidence':'by_guard='+b['substring'](0x0,0xa)+'...\x20(guards\x20list\x20not\x20supplied)','fix_hint':'Pass\x20input.guards\x20to\x20enable\x20membership\x20verification.'};const c=a['guards']['includes'](b);return{'id':'C-DEM-07','severity':c?'info':'block','title':'by_guard\x20exists\x20in\x20Demand.guards\x20(when\x20specified)','description':'When\x20by_guard\x20is\x20specified,\x20present_with_passport_imp\x20(demand.move:110-129)\x20iterates\x20the\x20guards\x20vector\x20'+'looking\x20for\x20a\x20matching\x20guard\x20address.\x20If\x20not\x20found,\x20it\x20aborts\x20with\x20E_GUARD_NOT_FOUND\x20(4).\x20The\x20caller\x20'+'MUST\x20ensure\x20by_guard\x20was\x20previously\x20added\x20via\x20guard_add.','passed':c,'evidence':'by_guard='+b['substring'](0x0,0xa)+'...,\x20in\x20guards='+c,'fix_hint':c?undefined:'Call\x20guard_add(permission,\x20guard,\x20service_identifier)\x20first.'};}function checkPermissionSetAvailable(a){const b=a['permission_set_available']!==![];return{'id':'C-DEM-08','severity':b?'info':'warn','title':'permission_set\x20available\x20via\x20CallPermission.apply\x20(DE-D-2=A)','description':'The\x20Move\x20permission_set\x20function\x20(demand.move:286)\x20is\x20exposed\x20in\x20the\x20SDK\x20via\x20the\x20CallPermission.apply\x20'+'mechanism\x20(DE-D-2=A).\x20It\x20calls\x20permission::assert_owner(old)\x20and\x20registrar::affiliation_change\x20to\x20migrate\x20'+'the\x20affiliation.\x20Permission\x20indices\x20for\x20Demand\x20(demand.move:20):\x20400=DEMAND_NEW,\x20401=DEMAND_DESCRIPTION,\x20'+'402=DEMAND_LOCATION,\x20404=DEMAND_GUARD,\x20405=DEMAND_REWARD,\x20406=DEMAND_FEEDBACK,\x20407=DEMAND_OWNER_RECEIVE,\x20'+'408=DEMAND_UM.\x20This\x20is\x20an\x20info\x20check\x20—\x20it\x20confirms\x20the\x20capability\x20is\x20available,\x20not\x20a\x20creation\x20prerequisite.','passed':b,'evidence':b?'exposed\x20via\x20CallPermission.apply':'not\x20available\x20(regression)','fix_hint':b?undefined:'Restore\x20the\x20CallPermission.apply\x20path\x20for\x20permission_set.'};}export function preCheckDemandCreation(a){return[checkDescription(a),checkLocation(a),checkRewards(a),checkGuards(a),checkFeedback(a),checkServiceIdentifier(a),checkByGuard(a),checkPermissionSetAvailable(a)];}export function canCreateDemand(a){const b=preCheckDemandCreation(a);return{'canCreate':b['every'](c=>c['severity']!=='block'||c['passed']),'blockers':b['filter'](c=>c['severity']==='block'&&!c['passed']),'warnings':b['filter'](c=>c['severity']==='warn'&&!c['passed']),'info':b['filter'](c=>c['severity']==='info')};}export function formatDemandCreationSummary(a){const {canCreate:b,blockers:c,warnings:d,info:e}=canCreateDemand(a),f=[];return f['push'](b?'✓\x20Demand\x20pre-check\x20PASSED':'✗\x20Demand\x20pre-check\x20FAILED'),f['push'](''),c['length']>0x0&&(f['push']('BLOCKERS\x20(must\x20fix\x20before\x20operation):'),c['forEach'](g=>f['push']('\x20\x20['+g['id']+']\x20'+g['title']+'\x20—\x20'+(g['evidence']??''))),f['push']('')),d['length']>0x0&&(f['push']('WARNINGS\x20(review\x20recommended):'),d['forEach'](g=>f['push']('\x20\x20['+g['id']+']\x20'+g['title']+'\x20—\x20'+(g['evidence']??''))),f['push']('')),e['length']>0x0&&(f['push']('INFO:'),e['forEach'](g=>f['push']('\x20\x20['+g['id']+']\x20'+g['title']))),f['join']('\x0a');}

package/dist/knowledge/demand-matching.js

@@ -1,132 +1 @@
-export const DEMAND_MATCHING_VERSION = 1;
-const WEIGHTS = {
-    tags: 30,
-    price: 20,
-    scenario: 15,
-    trust: 20,
-    location: 10,
-    keyword: 5,
-};
-export function matchDemand(demand, services, limit = 5) {
-    const matches = services
-        .filter((s) => s.published !== false)
-        .map((s) => computeMatchScore(demand, s))
-        .filter((m) => m.score >= 60)
-        .sort((a, b) => b.score - a.score)
-        .slice(0, limit);
-    return matches;
-}
-function computeMatchScore(demand, service) {
-    const reasons = [];
-    const warnings = [];
-    let score = 0;
-    const tagScore = computeTagScore(demand.tags, service.tags);
-    score += tagScore;
-    if (tagScore >= WEIGHTS.tags * 0.8) {
-        reasons.push(`High tags match (${tagScore}/${WEIGHTS.tags})`);
-    }
-    const priceScore = computePriceScore(demand.maxPrice, service.price);
-    score += priceScore;
-    if (priceScore === WEIGHTS.price) {
-        reasons.push(`Price within budget`);
-    }
-    else if (priceScore === 0 && demand.maxPrice && service.price) {
-        warnings.push(`Price exceeds budget (${service.price} > ${demand.maxPrice})`);
-    }
-    const scenarioScore = computeScenarioScore(demand.scenario, service.scenario);
-    score += scenarioScore;
-    if (scenarioScore === WEIGHTS.scenario) {
-        reasons.push(`Industry scenario matches (${service.scenario})`);
-    }
-    const trustScore = computeTrustScore(service.trustScore, demand.minTrustScore);
-    score += trustScore;
-    if (service.trustScore !== undefined) {
-        if (service.trustScore >= 75) {
-            reasons.push(`High trust score (${service.trustScore}/100)`);
-        }
-        else if (service.trustScore < 50) {
-            warnings.push(`Low trust score (${service.trustScore}/100)`);
-        }
-    }
-    const locationScore = computeLocationScore(demand.location, service.location);
-    score += locationScore;
-    if (locationScore === WEIGHTS.location && demand.location) {
-        reasons.push(`Geographic location matches (${service.location})`);
-    }
-    const keywordScore = computeKeywordScore(demand.keywords, service.description);
-    score += keywordScore;
-    if (demand.minTrustScore !== undefined && service.trustScore !== undefined) {
-        if (service.trustScore < demand.minTrustScore) {
-            warnings.push(`Trust score below requirement (${service.trustScore} < ${demand.minTrustScore})`);
-            score -= 10;
-        }
-    }
-    return {
-        service,
-        score: Math.max(0, Math.min(100, score)),
-        reasons,
-        warnings,
-    };
-}
-function computeTagScore(demandTags, serviceTags) {
-    if (!demandTags || !serviceTags || demandTags.length === 0 || serviceTags.length === 0)
-        return 0;
-    const demandSet = new Set(demandTags.map((t) => t.toLowerCase()));
-    const serviceSet = new Set(serviceTags.map((t) => t.toLowerCase()));
-    const overlap = [...demandSet].filter((t) => serviceSet.has(t)).length;
-    return Math.round((overlap / demandSet.size) * WEIGHTS.tags);
-}
-function computePriceScore(maxPrice, servicePrice) {
-    if (!maxPrice || !servicePrice)
-        return WEIGHTS.price / 2;
-    try {
-        const max = BigInt(maxPrice);
-        const price = BigInt(servicePrice);
-        if (price <= max)
-            return WEIGHTS.price;
-        if (price <= max * 110n / 100n)
-            return WEIGHTS.price * 0.5;
-        return 0;
-    }
-    catch {
-        return WEIGHTS.price / 2;
-    }
-}
-function computeScenarioScore(demandScenario, serviceScenario) {
-    if (!demandScenario || !serviceScenario)
-        return 0;
-    return demandScenario.toLowerCase() === serviceScenario.toLowerCase() ? WEIGHTS.scenario : 0;
-}
-function computeTrustScore(serviceTrust, minTrust) {
-    if (serviceTrust === undefined)
-        return WEIGHTS.trust / 2;
-    if (serviceTrust >= 75)
-        return WEIGHTS.trust;
-    if (serviceTrust >= 50)
-        return WEIGHTS.trust * 0.6;
-    if (serviceTrust >= 25)
-        return WEIGHTS.trust * 0.3;
-    return 0;
-}
-function computeLocationScore(demandLocation, serviceLocation) {
-    if (!demandLocation || !serviceLocation)
-        return 0;
-    return demandLocation.toLowerCase() === serviceLocation.toLowerCase() ? WEIGHTS.location : 0;
-}
-function computeKeywordScore(keywords, description) {
-    if (!keywords || !description || keywords.length === 0)
-        return 0;
-    const desc = description.toLowerCase();
-    const matches = keywords.filter((k) => desc.includes(k.toLowerCase()));
-    return Math.min(WEIGHTS.keyword, matches.length);
-}
-export function extractDemandInfo(demandData) {
-    return {
-        tags: demandData?.tags,
-        maxPrice: demandData?.max_price ?? demandData?.maxPrice,
-        scenario: demandData?.scenario,
-        location: demandData?.location,
-        minTrustScore: demandData?.min_trust_score ?? demandData?.minTrustScore,
-        keywords: demandData?.keywords,
-    };
-}
+export const DEMAND_MATCHING_VERSION=0x1;const WEIGHTS={'tags':0x1e,'price':0x14,'scenario':0xf,'trust':0x14,'location':0xa,'keyword':0x5};export function matchDemand(a,b,c=0x5){const d=b['filter'](e=>e['published']!==![])['map'](e=>computeMatchScore(a,e))['filter'](e=>e['score']>=0x3c)['sort']((e,f)=>f['score']-e['score'])['slice'](0x0,c);return d;}function computeMatchScore(a,b){const c=[],d=[];let e=0x0;const f=computeTagScore(a['tags'],b['tags']);e+=f;f>=WEIGHTS['tags']*0.8&&c['push']('High\x20tags\x20match\x20('+f+'/'+WEIGHTS['tags']+')');const g=computePriceScore(a['maxPrice'],b['price']);e+=g;if(g===WEIGHTS['price'])c['push']('Price\x20within\x20budget');else g===0x0&&a['maxPrice']&&b['price']&&d['push']('Price\x20exceeds\x20budget\x20('+b['price']+'\x20>\x20'+a['maxPrice']+')');const h=computeScenarioScore(a['scenario'],b['scenario']);e+=h;h===WEIGHTS['scenario']&&c['push']('Industry\x20scenario\x20matches\x20('+b['scenario']+')');const i=computeTrustScore(b['trustScore'],a['minTrustScore']);e+=i;if(b['trustScore']!==undefined){if(b['trustScore']>=0x4b)c['push']('High\x20trust\x20score\x20('+b['trustScore']+'/100)');else b['trustScore']<0x32&&d['push']('Low\x20trust\x20score\x20('+b['trustScore']+'/100)');}const j=computeLocationScore(a['location'],b['location']);e+=j;j===WEIGHTS['location']&&a['location']&&c['push']('Geographic\x20location\x20matches\x20('+b['location']+')');const k=computeKeywordScore(a['keywords'],b['description']);return e+=k,a['minTrustScore']!==undefined&&b['trustScore']!==undefined&&(b['trustScore']<a['minTrustScore']&&(d['push']('Trust\x20score\x20below\x20requirement\x20('+b['trustScore']+'\x20<\x20'+a['minTrustScore']+')'),e-=0xa)),{'service':b,'score':Math['max'](0x0,Math['min'](0x64,e)),'reasons':c,'warnings':d};}function computeTagScore(a,b){if(!a||!b||a['length']===0x0||b['length']===0x0)return 0x0;const c=new Set(a['map'](f=>f['toLowerCase']())),d=new Set(b['map'](f=>f['toLowerCase']())),e=[...c]['filter'](f=>d['has'](f))['length'];return Math['round'](e/c['size']*WEIGHTS['tags']);}function computePriceScore(a,b){if(!a||!b)return WEIGHTS['price']/0x2;try{const c=BigInt(a),d=BigInt(b);if(d<=c)return WEIGHTS['price'];if(d<=c*0x6en/0x64n)return WEIGHTS['price']*0.5;return 0x0;}catch{return WEIGHTS['price']/0x2;}}function computeScenarioScore(a,b){if(!a||!b)return 0x0;return a['toLowerCase']()===b['toLowerCase']()?WEIGHTS['scenario']:0x0;}function computeTrustScore(a,b){if(a===undefined)return WEIGHTS['trust']/0x2;if(a>=0x4b)return WEIGHTS['trust'];if(a>=0x32)return WEIGHTS['trust']*0.6;if(a>=0x19)return WEIGHTS['trust']*0.3;return 0x0;}function computeLocationScore(a,b){if(!a||!b)return 0x0;return a['toLowerCase']()===b['toLowerCase']()?WEIGHTS['location']:0x0;}function computeKeywordScore(a,b){if(!a||!b||a['length']===0x0)return 0x0;const c=b['toLowerCase'](),d=a['filter'](e=>c['includes'](e['toLowerCase']()));return Math['min'](WEIGHTS['keyword'],d['length']);}export function extractDemandInfo(a){return{'tags':a?.['tags'],'maxPrice':a?.['max_price']??a?.['maxPrice'],'scenario':a?.['scenario'],'location':a?.['location'],'minTrustScore':a?.['min_trust_score']??a?.['minTrustScore'],'keywords':a?.['keywords']};}