@wowok/agent-mcp 2.7.1 → 2.7.2

package/dist/project/mode-actions.js

@@ -1,309 +1 @@
-import { getIndustryModeRegistry, getMetricRegistry, getConstraintRegistry, } from "../extensions/index.js";
-import { inferTraitsFromDescription, findSimilarIndustries, } from "../knowledge/industry-generalizer.js";
-import { searchExamples } from "../schema-query/index.js";
-const LOCAL_MODE_OWNER = "local";
-const RM1_11_NODE_REGEX = /(^|_)(disputed?|refund(?:ed)?|arbitration|arb)(_|$)/i;
-function validateMachineShape(machineShape, fieldName) {
-    const violations = [];
-    if (!Array.isArray(machineShape))
-        return violations;
-    const seen = new Set();
-    for (const node of machineShape) {
-        const name = node?.name;
-        if (typeof name !== "string" || !name) {
-            violations.push(`${fieldName}: every node must have a non-empty string 'name'`);
-            continue;
-        }
-        if (seen.has(name)) {
-            violations.push(`${fieldName}: duplicate node name '${name}' (R-M1-10)`);
-        }
-        seen.add(name);
-        if (RM1_11_NODE_REGEX.test(name)) {
-            violations.push(`${fieldName}: node '${name}' violates R-M1-11 — dispute/refund flows must NOT be ` +
-                `modeled as Machine nodes. Disputes flow through Service.arbitrations → Arbitration.dispute() ` +
-                `independently of the Machine. Use business-state nodes (e.g. 'cancelled', 'return_approved') ` +
-                `and route fund refunds via Allocator triggered by those states.`);
-        }
-    }
-    return violations;
-}
-export function handleRecommendIndustry(v) {
-    const intent = (v.intent ?? v.project_description ?? v.project_name ?? "").trim();
-    if (!intent) {
-        throw new Error("recommend_industry requires 'intent' (business description text). " +
-            "Example: intent='I rent cameras to photographers with deposit and damage inspection'.");
-    }
-    const inference = inferTraitsFromDescription(intent);
-    const matches = findSimilarIndustries(inference.traits, 3);
-    const recommendations = matches.map((m) => {
-        const examples = searchExamples(m.industry).slice(0, 3).map((e) => ({
-            file: e.file,
-            title: e.title,
-            operation_type: e.operation_type,
-            verified: e.verified,
-        }));
-        return {
-            industry: m.industry,
-            similarity: m.similarity,
-            matched_traits: m.matched_traits,
-            reference_examples: examples,
-        };
-    });
-    const top = recommendations[0];
-    return {
-        action: "recommend_industry",
-        intent,
-        inferred_traits: inference.traits,
-        inference_confidence: inference.confidence,
-        matched_keywords: inference.matched_keywords,
-        recommendations,
-        hint: top
-            ? `Top match: '${top.industry}' (similarity ${(top.similarity * 100).toFixed(0)}%). ` +
-                `Create the project with project_operation action='create_project' project_industry='${top.industry}' ` +
-                `to get a ready-made blueprint (~10 draft objects + graph edges), or choose another industry from ` +
-                `'recommendations', or use project_industry='custom' with skip_templates=true to build from scratch. ` +
-                `Review reference examples via schema_query action='search_examples' query='<industry>'.`
-            : "No similar industry found. Use project_industry='custom' with skip_templates=true to build from scratch.",
-    };
-}
-export async function handleListModes() {
-    const registry = getIndustryModeRegistry();
-    const builtin = registry.listModes()
-        .filter((m) => m.source === "builtin")
-        .map((m) => ({
-        name: m.name,
-        display_name: m.display_name,
-        version: m.version,
-        key_risk: m.key_risk,
-        machine_nodes: m.machine_shape.map((n) => n.name),
-        similar_industries: m.similar_industries ?? [],
-    }));
-    const userModes = (await registry.listUserModes(LOCAL_MODE_OWNER)).map((m) => ({
-        name: m.name,
-        display_name: m.display_name,
-        version: m.version,
-        derived_from: m.derived_from ?? null,
-        key_risk: m.key_risk,
-        machine_nodes: m.machine_shape.map((n) => n.name),
-        evolution_history: (m.evolution_history ?? []).map((h) => ({
-            version: h.version,
-            changed_at: h.changed_at,
-            changes: h.changes,
-        })),
-    }));
-    return {
-        action: "list_modes",
-        builtin_modes: builtin,
-        user_modes: userModes,
-        owner: LOCAL_MODE_OWNER,
-        hint: "Use a builtin mode name as project_industry in create_project. " +
-            "Use derive_user_mode to customize a builtin mode, or register_user_mode for a fully custom mode. " +
-            "User modes are referenced as '<name>' in derive/evolve/unregister actions.",
-    };
-}
-export async function handleDeriveUserMode(v) {
-    const source = requireField(v.mode_source, "mode_source");
-    const newName = requireField(v.mode_name, "mode_name");
-    const changes = v.mode_changes ?? {};
-    const violations = validateMachineShape(changes.machine_shape, "mode_changes.machine_shape");
-    if (violations.length > 0) {
-        throw new Error(`derive_user_mode blocked:\n${violations.join("\n")}`);
-    }
-    const registry = getIndustryModeRegistry();
-    const derived = await registry.deriveMode(source, changes, LOCAL_MODE_OWNER, newName, v.mode_display_name);
-    if (!derived) {
-        throw new Error(`derive_user_mode failed: source mode '${source}' not found, or name '${newName}' conflicts ` +
-            `with a builtin/existing user mode. Call list_modes to see available names.`);
-    }
-    return {
-        action: "derive_user_mode",
-        mode: summarizeUserMode(derived),
-        hint: `Mode '${newName}' derived from '${source}'. Use it as project_industry in create_project ` +
-            `(applyTemplate resolves user modes via 'local:${newName}'). Iterate with evolve_user_mode.`,
-    };
-}
-export async function handleEvolveUserMode(v) {
-    const name = requireField(v.mode_name, "mode_name");
-    const description = requireField(v.mode_change_description, "mode_change_description");
-    const changes = v.mode_changes ?? {};
-    const violations = validateMachineShape(changes.machine_shape, "mode_changes.machine_shape");
-    if (violations.length > 0) {
-        throw new Error(`evolve_user_mode blocked:\n${violations.join("\n")}`);
-    }
-    const registry = getIndustryModeRegistry();
-    const evolved = await registry.evolveMode(name, changes, LOCAL_MODE_OWNER, description, v.mode_bump_version ?? true);
-    if (!evolved) {
-        throw new Error(`evolve_user_mode failed: user mode '${name}' not found for owner '${LOCAL_MODE_OWNER}'. ` +
-            `Call list_modes to see your modes.`);
-    }
-    return {
-        action: "evolve_user_mode",
-        mode: summarizeUserMode(evolved),
-        hint: `Mode '${name}' evolved to ${evolved.version}. Evolution history recorded.`,
-    };
-}
-export async function handleRegisterUserMode(v) {
-    const name = requireField(v.mode_name, "mode_name");
-    const payload = v.mode_changes ?? {};
-    const missing = [];
-    if (!Array.isArray(payload.machine_shape) || payload.machine_shape.length === 0) {
-        missing.push("machine_shape (non-empty array of {name, role})");
-    }
-    if (typeof payload.key_risk !== "string" || !payload.key_risk) {
-        missing.push("key_risk (string describing the industry's key risk)");
-    }
-    if (missing.length > 0) {
-        throw new Error(`register_user_mode requires these fields in mode_changes: ${missing.join(", ")}. ` +
-            `Tip: derive_user_mode from a builtin mode is usually easier than registering from scratch.`);
-    }
-    const violations = validateMachineShape(payload.machine_shape, "mode_changes.machine_shape");
-    if (violations.length > 0) {
-        throw new Error(`register_user_mode blocked:\n${violations.join("\n")}`);
-    }
-    const registry = getIndustryModeRegistry();
-    const general = registry.getMode("general");
-    if (!general)
-        throw new Error("Builtin mode 'general' not registered — cannot build custom mode defaults");
-    const mode = {
-        ...general,
-        ...payload,
-        name,
-        display_name: v.mode_display_name ?? name,
-        version: "v1",
-        source: "custom",
-        owner: LOCAL_MODE_OWNER,
-        derived_from: undefined,
-        evolution_history: [],
-    };
-    const ok = await registry.registerUserMode(mode, LOCAL_MODE_OWNER);
-    if (!ok) {
-        throw new Error(`register_user_mode failed: name '${name}' conflicts with a builtin/existing user mode, ` +
-            `or payload is invalid. Call list_modes to see available names.`);
-    }
-    return {
-        action: "register_user_mode",
-        mode: summarizeUserMode(mode),
-        hint: `Custom mode '${name}' registered. Use it as project_industry in create_project.`,
-    };
-}
-export async function handleUnregisterUserMode(v) {
-    const name = requireField(v.mode_name, "mode_name");
-    const registry = getIndustryModeRegistry();
-    const ok = await registry.unregisterUserMode(name, LOCAL_MODE_OWNER);
-    if (!ok) {
-        throw new Error(`unregister_user_mode failed: user mode '${name}' not found for owner '${LOCAL_MODE_OWNER}'.`);
-    }
-    return {
-        action: "unregister_user_mode",
-        removed: true,
-        mode_name: name,
-    };
-}
-export function handleRegisterCustomMetric(v) {
-    const id = requireField(v.metric_id, "metric_id");
-    const displayName = requireField(v.metric_display_name, "metric_display_name");
-    const description = requireField(v.metric_description, "metric_description");
-    const type = requireField(v.metric_type, "metric_type");
-    const scale = requireField(v.metric_scale, "metric_scale");
-    const ok = getMetricRegistry().registerCustomMetric(id, displayName, description, type, scale, LOCAL_MODE_OWNER, v.metric_weight);
-    if (!ok) {
-        throw new Error(`register_custom_metric failed: metric_id '${id}' already exists or fields are invalid.`);
-    }
-    return {
-        action: "register_custom_metric",
-        metric: {
-            metric_id: id,
-            display_name: displayName,
-            description,
-            type,
-            scale,
-            weight: v.metric_weight ?? 1.0,
-            scope: "custom",
-            owner: LOCAL_MODE_OWNER,
-        },
-        hint: `Custom metric '${id}' registered globally — all modes can reference it via custom_metrics.`,
-    };
-}
-export function handleRegisterCustomConstraint(v) {
-    const id = requireField(v.constraint_id, "constraint_id");
-    const displayName = requireField(v.constraint_display_name, "constraint_display_name");
-    const description = requireField(v.constraint_description, "constraint_description");
-    const rule = v.constraint_rule;
-    if (!rule || typeof rule !== "object" || !("type" in rule)) {
-        throw new Error("constraint_rule is required and must be one of: " +
-            "{type:'capability_required', capability_id} | {type:'capability_forbidden', capability_id} | " +
-            "{type:'numeric_limit', field, max?, min?} | {type:'condition_required', condition, ai_evaluated:true}");
-    }
-    const ok = getConstraintRegistry().registerCustomConstraint(id, displayName, description, rule, LOCAL_MODE_OWNER, v.constraint_severity ?? "soft", v.constraint_on_violation ?? "warn");
-    if (!ok) {
-        throw new Error(`register_custom_constraint failed: constraint_id '${id}' already exists or rule is invalid.`);
-    }
-    return {
-        action: "register_custom_constraint",
-        constraint: {
-            constraint_id: id,
-            display_name: displayName,
-            description,
-            rule,
-            severity: v.constraint_severity ?? "soft",
-            on_violation: v.constraint_on_violation ?? "warn",
-            scope: "custom",
-            owner: LOCAL_MODE_OWNER,
-        },
-        hint: `Custom constraint '${id}' registered. 'hard' constraints block applyTemplate on violation; 'soft' only warn.`,
-    };
-}
-export function handleListMetricsConstraints(v) {
-    const metrics = getMetricRegistry().listMetrics({
-        type: v.metric_type_filter,
-        scope: v.scope_filter,
-    }).map((m) => ({
-        metric_id: m.metric_id,
-        display_name: m.display_name,
-        description: m.description,
-        type: m.type,
-        scale: m.scale,
-        weight: m.weight,
-        scope: m.scope,
-    }));
-    const constraints = getConstraintRegistry().listConstraints({
-        scope: v.scope_filter,
-    }).map((c) => ({
-        constraint_id: c.constraint_id,
-        display_name: c.display_name,
-        description: c.description,
-        rule: c.rule,
-        severity: c.severity,
-        on_violation: c.on_violation,
-        scope: c.scope,
-    }));
-    return {
-        action: "list_metrics_constraints",
-        metrics,
-        constraints,
-        hint: "Register custom entries via register_custom_metric / register_custom_constraint. " +
-            "Filter with metric_type_filter ('risk'|'benefit') or scope_filter ('builtin'|'custom').",
-    };
-}
-function requireField(value, fieldName) {
-    if (value === undefined || value === null || (typeof value === "string" && !value.trim())) {
-        throw new Error(`'${fieldName}' is required for this action`);
-    }
-    return value;
-}
-function summarizeUserMode(m) {
-    return {
-        name: m.name,
-        display_name: m.display_name,
-        version: m.version,
-        derived_from: m.derived_from ?? null,
-        owner: m.owner,
-        key_risk: m.key_risk,
-        machine_nodes: m.machine_shape.map((n) => n.name),
-        evolution_history: (m.evolution_history ?? []).map((h) => ({
-            version: h.version,
-            changed_at: h.changed_at,
-            changes: h.changes,
-        })),
-    };
-}
+import{getIndustryModeRegistry,getMetricRegistry,getConstraintRegistry}from'../extensions/index.js';import{inferTraitsFromDescription,findSimilarIndustries}from'../knowledge/industry-generalizer.js';import{searchExamples}from'../schema-query/index.js';const LOCAL_MODE_OWNER='local',RM1_11_NODE_REGEX=/(^|_)(disputed?|refund(?:ed)?|arbitration|arb)(_|$)/i;function validateMachineShape(a,b){const c=[];if(!Array['isArray'](a))return c;const d=new Set();for(const e of a){const f=e?.['name'];if(typeof f!=='string'||!f){c['push'](b+':\x20every\x20node\x20must\x20have\x20a\x20non-empty\x20string\x20\x27name\x27');continue;}d['has'](f)&&c['push'](b+':\x20duplicate\x20node\x20name\x20\x27'+f+'\x27\x20(R-M1-10)'),d['add'](f),RM1_11_NODE_REGEX['test'](f)&&c['push'](b+':\x20node\x20\x27'+f+'\x27\x20violates\x20R-M1-11\x20—\x20dispute/refund\x20flows\x20must\x20NOT\x20be\x20'+'modeled\x20as\x20Machine\x20nodes.\x20Disputes\x20flow\x20through\x20Service.arbitrations\x20→\x20Arbitration.dispute()\x20'+'independently\x20of\x20the\x20Machine.\x20Use\x20business-state\x20nodes\x20(e.g.\x20\x27cancelled\x27,\x20\x27return_approved\x27)\x20'+'and\x20route\x20fund\x20refunds\x20via\x20Allocator\x20triggered\x20by\x20those\x20states.');}return c;}export function handleRecommendIndustry(a){const b=(a['intent']??a['project_description']??a['project_name']??'')['trim']();if(!b)throw new Error('recommend_industry\x20requires\x20\x27intent\x27\x20(business\x20description\x20text).\x20'+'Example:\x20intent=\x27I\x20rent\x20cameras\x20to\x20photographers\x20with\x20deposit\x20and\x20damage\x20inspection\x27.');const c=inferTraitsFromDescription(b),d=findSimilarIndustries(c['traits'],0x3),e=d['map'](g=>{const h=searchExamples(g['industry'])['slice'](0x0,0x3)['map'](i=>({'file':i['file'],'title':i['title'],'operation_type':i['operation_type'],'verified':i['verified']}));return{'industry':g['industry'],'similarity':g['similarity'],'matched_traits':g['matched_traits'],'reference_examples':h};}),f=e[0x0];return{'action':'recommend_industry','intent':b,'inferred_traits':c['traits'],'inference_confidence':c['confidence'],'matched_keywords':c['matched_keywords'],'recommendations':e,'hint':f?'Top\x20match:\x20\x27'+f['industry']+'\x27\x20(similarity\x20'+(f['similarity']*0x64)['toFixed'](0x0)+'%).\x20'+('Create\x20the\x20project\x20with\x20project_operation\x20action=\x27create_project\x27\x20project_industry=\x27'+f['industry']+'\x27\x20')+'to\x20get\x20a\x20ready-made\x20blueprint\x20(~10\x20draft\x20objects\x20+\x20graph\x20edges),\x20or\x20choose\x20another\x20industry\x20from\x20'+'\x27recommendations\x27,\x20or\x20use\x20project_industry=\x27custom\x27\x20with\x20skip_templates=true\x20to\x20build\x20from\x20scratch.\x20'+'Review\x20reference\x20examples\x20via\x20schema_query\x20action=\x27search_examples\x27\x20query=\x27<industry>\x27.':'No\x20similar\x20industry\x20found.\x20Use\x20project_industry=\x27custom\x27\x20with\x20skip_templates=true\x20to\x20build\x20from\x20scratch.'};}export async function handleListModes(){const a=getIndustryModeRegistry(),b=a['listModes']()['filter'](d=>d['source']==='builtin')['map'](d=>({'name':d['name'],'display_name':d['display_name'],'version':d['version'],'key_risk':d['key_risk'],'machine_nodes':d['machine_shape']['map'](e=>e['name']),'similar_industries':d['similar_industries']??[]})),c=(await a['listUserModes'](LOCAL_MODE_OWNER))['map'](d=>({'name':d['name'],'display_name':d['display_name'],'version':d['version'],'derived_from':d['derived_from']??null,'key_risk':d['key_risk'],'machine_nodes':d['machine_shape']['map'](e=>e['name']),'evolution_history':(d['evolution_history']??[])['map'](e=>({'version':e['version'],'changed_at':e['changed_at'],'changes':e['changes']}))}));return{'action':'list_modes','builtin_modes':b,'user_modes':c,'owner':LOCAL_MODE_OWNER,'hint':'Use\x20a\x20builtin\x20mode\x20name\x20as\x20project_industry\x20in\x20create_project.\x20'+'Use\x20derive_user_mode\x20to\x20customize\x20a\x20builtin\x20mode,\x20or\x20register_user_mode\x20for\x20a\x20fully\x20custom\x20mode.\x20'+'User\x20modes\x20are\x20referenced\x20as\x20\x27<name>\x27\x20in\x20derive/evolve/unregister\x20actions.'};}export async function handleDeriveUserMode(a){const b=requireField(a['mode_source'],'mode_source'),c=requireField(a['mode_name'],'mode_name'),d=a['mode_changes']??{},e=validateMachineShape(d['machine_shape'],'mode_changes.machine_shape');if(e['length']>0x0)throw new Error('derive_user_mode\x20blocked:\x0a'+e['join']('\x0a'));const f=getIndustryModeRegistry(),g=await f['deriveMode'](b,d,LOCAL_MODE_OWNER,c,a['mode_display_name']);if(!g)throw new Error('derive_user_mode\x20failed:\x20source\x20mode\x20\x27'+b+'\x27\x20not\x20found,\x20or\x20name\x20\x27'+c+'\x27\x20conflicts\x20'+'with\x20a\x20builtin/existing\x20user\x20mode.\x20Call\x20list_modes\x20to\x20see\x20available\x20names.');return{'action':'derive_user_mode','mode':summarizeUserMode(g),'hint':'Mode\x20\x27'+c+'\x27\x20derived\x20from\x20\x27'+b+'\x27.\x20Use\x20it\x20as\x20project_industry\x20in\x20create_project\x20'+('(applyTemplate\x20resolves\x20user\x20modes\x20via\x20\x27local:'+c+'\x27).\x20Iterate\x20with\x20evolve_user_mode.')};}export async function handleEvolveUserMode(a){const b=requireField(a['mode_name'],'mode_name'),c=requireField(a['mode_change_description'],'mode_change_description'),d=a['mode_changes']??{},e=validateMachineShape(d['machine_shape'],'mode_changes.machine_shape');if(e['length']>0x0)throw new Error('evolve_user_mode\x20blocked:\x0a'+e['join']('\x0a'));const f=getIndustryModeRegistry(),g=await f['evolveMode'](b,d,LOCAL_MODE_OWNER,c,a['mode_bump_version']??!![]);if(!g)throw new Error('evolve_user_mode\x20failed:\x20user\x20mode\x20\x27'+b+'\x27\x20not\x20found\x20for\x20owner\x20\x27'+LOCAL_MODE_OWNER+'\x27.\x20'+'Call\x20list_modes\x20to\x20see\x20your\x20modes.');return{'action':'evolve_user_mode','mode':summarizeUserMode(g),'hint':'Mode\x20\x27'+b+'\x27\x20evolved\x20to\x20'+g['version']+'.\x20Evolution\x20history\x20recorded.'};}export async function handleRegisterUserMode(a){const b=requireField(a['mode_name'],'mode_name'),c=a['mode_changes']??{},d=[];(!Array['isArray'](c['machine_shape'])||c['machine_shape']['length']===0x0)&&d['push']('machine_shape\x20(non-empty\x20array\x20of\x20{name,\x20role})');(typeof c['key_risk']!=='string'||!c['key_risk'])&&d['push']('key_risk\x20(string\x20describing\x20the\x20industry\x27s\x20key\x20risk)');if(d['length']>0x0)throw new Error('register_user_mode\x20requires\x20these\x20fields\x20in\x20mode_changes:\x20'+d['join'](',\x20')+'.\x20'+'Tip:\x20derive_user_mode\x20from\x20a\x20builtin\x20mode\x20is\x20usually\x20easier\x20than\x20registering\x20from\x20scratch.');const e=validateMachineShape(c['machine_shape'],'mode_changes.machine_shape');if(e['length']>0x0)throw new Error('register_user_mode\x20blocked:\x0a'+e['join']('\x0a'));const f=getIndustryModeRegistry(),g=f['getMode']('general');if(!g)throw new Error('Builtin\x20mode\x20\x27general\x27\x20not\x20registered\x20—\x20cannot\x20build\x20custom\x20mode\x20defaults');const h={...g,...c,'name':b,'display_name':a['mode_display_name']??b,'version':'v1','source':'custom','owner':LOCAL_MODE_OWNER,'derived_from':undefined,'evolution_history':[]},i=await f['registerUserMode'](h,LOCAL_MODE_OWNER);if(!i)throw new Error('register_user_mode\x20failed:\x20name\x20\x27'+b+'\x27\x20conflicts\x20with\x20a\x20builtin/existing\x20user\x20mode,\x20'+'or\x20payload\x20is\x20invalid.\x20Call\x20list_modes\x20to\x20see\x20available\x20names.');return{'action':'register_user_mode','mode':summarizeUserMode(h),'hint':'Custom\x20mode\x20\x27'+b+'\x27\x20registered.\x20Use\x20it\x20as\x20project_industry\x20in\x20create_project.'};}export async function handleUnregisterUserMode(a){const b=requireField(a['mode_name'],'mode_name'),c=getIndustryModeRegistry(),d=await c['unregisterUserMode'](b,LOCAL_MODE_OWNER);if(!d)throw new Error('unregister_user_mode\x20failed:\x20user\x20mode\x20\x27'+b+'\x27\x20not\x20found\x20for\x20owner\x20\x27'+LOCAL_MODE_OWNER+'\x27.');return{'action':'unregister_user_mode','removed':!![],'mode_name':b};}export function handleRegisterCustomMetric(a){const b=requireField(a['metric_id'],'metric_id'),c=requireField(a['metric_display_name'],'metric_display_name'),d=requireField(a['metric_description'],'metric_description'),e=requireField(a['metric_type'],'metric_type'),f=requireField(a['metric_scale'],'metric_scale'),g=getMetricRegistry()['registerCustomMetric'](b,c,d,e,f,LOCAL_MODE_OWNER,a['metric_weight']);if(!g)throw new Error('register_custom_metric\x20failed:\x20metric_id\x20\x27'+b+'\x27\x20already\x20exists\x20or\x20fields\x20are\x20invalid.');return{'action':'register_custom_metric','metric':{'metric_id':b,'display_name':c,'description':d,'type':e,'scale':f,'weight':a['metric_weight']??0x1,'scope':'custom','owner':LOCAL_MODE_OWNER},'hint':'Custom\x20metric\x20\x27'+b+'\x27\x20registered\x20globally\x20—\x20all\x20modes\x20can\x20reference\x20it\x20via\x20custom_metrics.'};}export function handleRegisterCustomConstraint(a){const b=requireField(a['constraint_id'],'constraint_id'),c=requireField(a['constraint_display_name'],'constraint_display_name'),d=requireField(a['constraint_description'],'constraint_description'),e=a['constraint_rule'];if(!e||typeof e!=='object'||!('type'in e))throw new Error('constraint_rule\x20is\x20required\x20and\x20must\x20be\x20one\x20of:\x20'+'{type:\x27capability_required\x27,\x20capability_id}\x20|\x20{type:\x27capability_forbidden\x27,\x20capability_id}\x20|\x20'+'{type:\x27numeric_limit\x27,\x20field,\x20max?,\x20min?}\x20|\x20{type:\x27condition_required\x27,\x20condition,\x20ai_evaluated:true}');const f=getConstraintRegistry()['registerCustomConstraint'](b,c,d,e,LOCAL_MODE_OWNER,a['constraint_severity']??'soft',a['constraint_on_violation']??'warn');if(!f)throw new Error('register_custom_constraint\x20failed:\x20constraint_id\x20\x27'+b+'\x27\x20already\x20exists\x20or\x20rule\x20is\x20invalid.');return{'action':'register_custom_constraint','constraint':{'constraint_id':b,'display_name':c,'description':d,'rule':e,'severity':a['constraint_severity']??'soft','on_violation':a['constraint_on_violation']??'warn','scope':'custom','owner':LOCAL_MODE_OWNER},'hint':'Custom\x20constraint\x20\x27'+b+'\x27\x20registered.\x20\x27hard\x27\x20constraints\x20block\x20applyTemplate\x20on\x20violation;\x20\x27soft\x27\x20only\x20warn.'};}export function handleListMetricsConstraints(a){const b=getMetricRegistry()['listMetrics']({'type':a['metric_type_filter'],'scope':a['scope_filter']})['map'](d=>({'metric_id':d['metric_id'],'display_name':d['display_name'],'description':d['description'],'type':d['type'],'scale':d['scale'],'weight':d['weight'],'scope':d['scope']})),c=getConstraintRegistry()['listConstraints']({'scope':a['scope_filter']})['map'](d=>({'constraint_id':d['constraint_id'],'display_name':d['display_name'],'description':d['description'],'rule':d['rule'],'severity':d['severity'],'on_violation':d['on_violation'],'scope':d['scope']}));return{'action':'list_metrics_constraints','metrics':b,'constraints':c,'hint':'Register\x20custom\x20entries\x20via\x20register_custom_metric\x20/\x20register_custom_constraint.\x20'+'Filter\x20with\x20metric_type_filter\x20(\x27risk\x27|\x27benefit\x27)\x20or\x20scope_filter\x20(\x27builtin\x27|\x27custom\x27).'};}function requireField(a,b){if(a===undefined||a===null||typeof a==='string'&&!a['trim']())throw new Error('\x27'+b+'\x27\x20is\x20required\x20for\x20this\x20action');return a;}function summarizeUserMode(a){return{'name':a['name'],'display_name':a['display_name'],'version':a['version'],'derived_from':a['derived_from']??null,'owner':a['owner'],'key_risk':a['key_risk'],'machine_nodes':a['machine_shape']['map'](b=>b['name']),'evolution_history':(a['evolution_history']??[])['map'](b=>({'version':b['version'],'changed_at':b['changed_at'],'changes':b['changes']}))};}

package/dist/project/namespace.js

@@ -1,206 +1 @@
-export const TAG_PREFIX = {
-    project: "project:",
-    type: "type:",
-    role: "role:",
-    industry: "industry:",
-    version: "version:",
-    shareable: "shareable:",
-    archived: "archived:",
-};
-export const NAMESPACE_CONSTRAINTS = {
-    projectPrefixMin: 3,
-    projectPrefixMax: 16,
-    purposeMin: 1,
-    purposeMax: 32,
-    versionPattern: /^v\d+$/,
-};
-export function validateProjectName(name) {
-    if (!name || typeof name !== "string") {
-        return { valid: false, reason: "name is empty" };
-    }
-    if (name.startsWith("0x")) {
-        return { valid: false, reason: "name must not start with '0x'" };
-    }
-    if (/^0x[0-9a-fA-F]{64}$/.test(name)) {
-        return { valid: false, reason: "name is an on-chain address, not a project name" };
-    }
-    const parts = name.split("_");
-    if (parts.length < 3) {
-        return {
-            valid: false,
-            reason: "name does not match `<prefix>_<type>_<purpose>[_v<version>]`",
-        };
-    }
-    const projectPrefix = parts[0];
-    const typeStr = parts[1];
-    let version;
-    let purpose;
-    const last = parts[parts.length - 1];
-    if (NAMESPACE_CONSTRAINTS.versionPattern.test(last)) {
-        version = last;
-        purpose = parts.slice(2, -1).join("_") || parts[2];
-    }
-    else {
-        purpose = parts.slice(2).join("_");
-    }
-    if (projectPrefix.length < NAMESPACE_CONSTRAINTS.projectPrefixMin) {
-        return { valid: false, reason: `projectPrefix too short (min ${NAMESPACE_CONSTRAINTS.projectPrefixMin})` };
-    }
-    if (projectPrefix.length > NAMESPACE_CONSTRAINTS.projectPrefixMax) {
-        return { valid: false, reason: `projectPrefix too long (max ${NAMESPACE_CONSTRAINTS.projectPrefixMax})` };
-    }
-    if (!/^[a-z][a-z0-9]*$/.test(projectPrefix)) {
-        return { valid: false, reason: "projectPrefix must be lowercase alphanumeric (start with a letter)" };
-    }
-    if (!isProjectObjectType(typeStr)) {
-        return { valid: false, reason: `unknown object type '${typeStr}'` };
-    }
-    if (!purpose || purpose.length < NAMESPACE_CONSTRAINTS.purposeMin) {
-        return { valid: false, reason: "purpose is empty" };
-    }
-    if (purpose.length > NAMESPACE_CONSTRAINTS.purposeMax) {
-        return { valid: false, reason: `purpose too long (max ${NAMESPACE_CONSTRAINTS.purposeMax})` };
-    }
-    if (!/^[a-zA-Z][a-zA-Z0-9]*$/.test(purpose)) {
-        return { valid: false, reason: "purpose must be alphanumeric (start with a letter)" };
-    }
-    return {
-        valid: true,
-        parsed: { projectPrefix, type: typeStr, purpose, version },
-    };
-}
-function isProjectObjectType(s) {
-    return [
-        "service", "machine", "guard", "permission", "reward", "arb",
-        "progress", "treasury", "demand", "repository", "contact", "order",
-        "allocation", "personal", "payment", "proof",
-    ].includes(s);
-}
-export function objectTypeFromOperation(operation_type) {
-    const direct = {
-        service: "service",
-        machine: "machine",
-        guard: "guard",
-        permission: "permission",
-        reward: "reward",
-        arbitration: "arb",
-        progress: "progress",
-        treasury: "treasury",
-        demand: "demand",
-        repository: "repository",
-        contact: "contact",
-        order: "order",
-        allocation: "allocation",
-        personal: "personal",
-        payment: "payment",
-        proof: "proof",
-    };
-    return direct[operation_type];
-}
-export function buildProjectTags(opts) {
-    const tags = new Set(opts.existingTags ?? []);
-    if (opts.projectPrefix) {
-        tags.add(`${TAG_PREFIX.project}${opts.projectPrefix}`);
-        if (opts.version) {
-            tags.add(`${TAG_PREFIX.project}${opts.projectPrefix}_${opts.version}`);
-        }
-    }
-    if (opts.type) {
-        tags.add(`${TAG_PREFIX.type}${opts.type}`);
-    }
-    if (opts.role) {
-        tags.add(`${TAG_PREFIX.role}${opts.role}`);
-    }
-    if (opts.industry) {
-        tags.add(`${TAG_PREFIX.industry}${opts.industry}`);
-    }
-    if (opts.version) {
-        tags.add(`${TAG_PREFIX.version}${opts.version}`);
-    }
-    if (opts.shareable) {
-        tags.add(`${TAG_PREFIX.shareable}true`);
-    }
-    return Array.from(tags);
-}
-export function parseProjectTagValue(value) {
-    const m = value.match(/^(.+?)_(v\d+)$/);
-    if (m) {
-        return { prefix: m[1], version: m[2] };
-    }
-    return { prefix: value };
-}
-export function extractAllProjectVersions(tags) {
-    if (!tags)
-        return [];
-    const result = [];
-    for (const t of tags) {
-        if (!t.startsWith(TAG_PREFIX.project))
-            continue;
-        const value = t.slice(TAG_PREFIX.project.length);
-        const parsed = parseProjectTagValue(value);
-        result.push({ ...parsed, raw: t });
-    }
-    return result;
-}
-export function extractProjectPrefix(tags) {
-    if (!tags)
-        return undefined;
-    for (const t of tags) {
-        if (t.startsWith(TAG_PREFIX.project)) {
-            const value = t.slice(TAG_PREFIX.project.length);
-            const parsed = parseProjectTagValue(value);
-            return parsed.prefix;
-        }
-    }
-    return undefined;
-}
-export function normalizeForProject(input) {
-    const warnings = [];
-    const data = input.data;
-    if (!data || typeof data !== "object") {
-        return { data, warnings };
-    }
-    const namedNew = data.namedNew ?? data.object;
-    if (!namedNew || typeof namedNew !== "object") {
-        return { data, warnings };
-    }
-    const name = namedNew.name;
-    const inferredType = objectTypeFromOperation(input.operation_type);
-    let prefix = input.projectPrefix;
-    let version = input.version;
-    let nameValidation;
-    if (name) {
-        nameValidation = validateProjectName(name);
-        if (nameValidation.valid && nameValidation.parsed) {
-            prefix = prefix ?? nameValidation.parsed.projectPrefix;
-            version = version ?? nameValidation.parsed.version;
-        }
-        else if (nameValidation.reason && !nameValidation.reason.includes("address")) {
-            warnings.push(`Object name '${name}' does not follow the project naming convention ` +
-                `'<prefix>_<type>_<purpose>[_v<version>]': ${nameValidation.reason}. ` +
-                `Consider renaming for better project organization.`);
-        }
-    }
-    if (!prefix) {
-        return { data, warnings };
-    }
-    const existingTags = Array.isArray(namedNew.tags) ? namedNew.tags : [];
-    const projectTags = buildProjectTags({
-        projectPrefix: prefix,
-        type: inferredType,
-        role: input.role,
-        industry: input.industry,
-        version,
-        shareable: input.shareable,
-        existingTags,
-    });
-    if (projectTags.length > existingTags.length) {
-        namedNew.tags = projectTags;
-    }
-    return {
-        data,
-        warnings,
-        project: { prefix, type: inferredType, version },
-    };
-}
-export const NAMESPACE_VERSION = 2;
+export const TAG_PREFIX={'project':'project:','type':'type:','role':'role:','industry':'industry:','version':'version:','shareable':'shareable:','archived':'archived:'};export const NAMESPACE_CONSTRAINTS={'projectPrefixMin':0x3,'projectPrefixMax':0x10,'purposeMin':0x1,'purposeMax':0x20,'versionPattern':/^v\d+$/};export function validateProjectName(a){if(!a||typeof a!=='string')return{'valid':![],'reason':'name\x20is\x20empty'};if(a['startsWith']('0x'))return{'valid':![],'reason':'name\x20must\x20not\x20start\x20with\x20\x270x\x27'};if(/^0x[0-9a-fA-F]{64}$/['test'](a))return{'valid':![],'reason':'name\x20is\x20an\x20on-chain\x20address,\x20not\x20a\x20project\x20name'};const b=a['split']('_');if(b['length']<0x3)return{'valid':![],'reason':'name\x20does\x20not\x20match\x20`<prefix>_<type>_<purpose>[_v<version>]`'};const c=b[0x0],d=b[0x1];let e,f;const g=b[b['length']-0x1];NAMESPACE_CONSTRAINTS['versionPattern']['test'](g)?(e=g,f=b['slice'](0x2,-0x1)['join']('_')||b[0x2]):f=b['slice'](0x2)['join']('_');if(c['length']<NAMESPACE_CONSTRAINTS['projectPrefixMin'])return{'valid':![],'reason':'projectPrefix\x20too\x20short\x20(min\x20'+NAMESPACE_CONSTRAINTS['projectPrefixMin']+')'};if(c['length']>NAMESPACE_CONSTRAINTS['projectPrefixMax'])return{'valid':![],'reason':'projectPrefix\x20too\x20long\x20(max\x20'+NAMESPACE_CONSTRAINTS['projectPrefixMax']+')'};if(!/^[a-z][a-z0-9]*$/['test'](c))return{'valid':![],'reason':'projectPrefix\x20must\x20be\x20lowercase\x20alphanumeric\x20(start\x20with\x20a\x20letter)'};if(!isProjectObjectType(d))return{'valid':![],'reason':'unknown\x20object\x20type\x20\x27'+d+'\x27'};if(!f||f['length']<NAMESPACE_CONSTRAINTS['purposeMin'])return{'valid':![],'reason':'purpose\x20is\x20empty'};if(f['length']>NAMESPACE_CONSTRAINTS['purposeMax'])return{'valid':![],'reason':'purpose\x20too\x20long\x20(max\x20'+NAMESPACE_CONSTRAINTS['purposeMax']+')'};if(!/^[a-zA-Z][a-zA-Z0-9]*$/['test'](f))return{'valid':![],'reason':'purpose\x20must\x20be\x20alphanumeric\x20(start\x20with\x20a\x20letter)'};return{'valid':!![],'parsed':{'projectPrefix':c,'type':d,'purpose':f,'version':e}};}function isProjectObjectType(a){return['service','machine','guard','permission','reward','arb','progress','treasury','demand','repository','contact','order','allocation','personal','payment','proof']['includes'](a);}export function objectTypeFromOperation(a){const b={'service':'service','machine':'machine','guard':'guard','permission':'permission','reward':'reward','arbitration':'arb','progress':'progress','treasury':'treasury','demand':'demand','repository':'repository','contact':'contact','order':'order','allocation':'allocation','personal':'personal','payment':'payment','proof':'proof'};return b[a];}export function buildProjectTags(a){const b=new Set(a['existingTags']??[]);return a['projectPrefix']&&(b['add'](''+TAG_PREFIX['project']+a['projectPrefix']),a['version']&&b['add'](''+TAG_PREFIX['project']+a['projectPrefix']+'_'+a['version'])),a['type']&&b['add'](''+TAG_PREFIX['type']+a['type']),a['role']&&b['add'](''+TAG_PREFIX['role']+a['role']),a['industry']&&b['add'](''+TAG_PREFIX['industry']+a['industry']),a['version']&&b['add'](''+TAG_PREFIX['version']+a['version']),a['shareable']&&b['add'](TAG_PREFIX['shareable']+'true'),Array['from'](b);}export function parseProjectTagValue(a){const b=a['match'](/^(.+?)_(v\d+)$/);if(b)return{'prefix':b[0x1],'version':b[0x2]};return{'prefix':a};}export function extractAllProjectVersions(a){if(!a)return[];const b=[];for(const c of a){if(!c['startsWith'](TAG_PREFIX['project']))continue;const d=c['slice'](TAG_PREFIX['project']['length']),e=parseProjectTagValue(d);b['push']({...e,'raw':c});}return b;}export function extractProjectPrefix(a){if(!a)return undefined;for(const b of a){if(b['startsWith'](TAG_PREFIX['project'])){const c=b['slice'](TAG_PREFIX['project']['length']),d=parseProjectTagValue(c);return d['prefix'];}}return undefined;}export function normalizeForProject(a){const b=[],c=a['data'];if(!c||typeof c!=='object')return{'data':c,'warnings':b};const d=c['namedNew']??c['object'];if(!d||typeof d!=='object')return{'data':c,'warnings':b};const e=d['name'],f=objectTypeFromOperation(a['operation_type']);let g=a['projectPrefix'],h=a['version'],i;if(e){i=validateProjectName(e);if(i['valid']&&i['parsed'])g=g??i['parsed']['projectPrefix'],h=h??i['parsed']['version'];else i['reason']&&!i['reason']['includes']('address')&&b['push']('Object\x20name\x20\x27'+e+'\x27\x20does\x20not\x20follow\x20the\x20project\x20naming\x20convention\x20'+('\x27<prefix>_<type>_<purpose>[_v<version>]\x27:\x20'+i['reason']+'.\x20')+'Consider\x20renaming\x20for\x20better\x20project\x20organization.');}if(!g)return{'data':c,'warnings':b};const j=Array['isArray'](d['tags'])?d['tags']:[],k=buildProjectTags({'projectPrefix':g,'type':f,'role':a['role'],'industry':a['industry'],'version':h,'shareable':a['shareable'],'existingTags':j});return k['length']>j['length']&&(d['tags']=k),{'data':c,'warnings':b,'project':{'prefix':g,'type':f,'version':h}};}export const NAMESPACE_VERSION=0x2;