@wowok/agent-mcp 2.7.1 → 2.7.2

package/dist/knowledge/guard-context.js

@@ -1,287 +1 @@
-import { GUARD_SCENES, findScene, } from "./guard-ledger.js";
-import { getTemplatesByScene, } from "./guard-templates.js";
-import { matchSemanticPattern, } from "./guard-translation.js";
-import { getAllRiskRules, assessGuardRisks, } from "./guard-risk.js";
-import { initPuzzleFromIntent, checkPuzzleCompleteness, } from "./guard-puzzle.js";
-import { GUARD_PUBLISH_CHECKLIST, GUARD_CONFIRMATION_QUESTIONS, } from "./guard-confirm.js";
-import { MAX_TABLE_SIZE, MAX_DESCRIPTION_LENGTH, } from "@wowok/wowok";
-import { MACHINE_SCENES, } from "./machine-ledger.js";
-export const GUARD_CONTEXT_VERSION = "1.0.0";
-export function buildGuardContext(input) {
-    const max_length = input.max_length ?? 4000;
-    let matched_scene;
-    if (input.intent) {
-        matched_scene = findSceneByIntentKeywords(input.intent);
-    }
-    else if (input.guard_json?.binding_scene_id) {
-        matched_scene = GUARD_SCENES.find(s => s.id === input.guard_json.binding_scene_id);
-    }
-    else if (input.target_host_object && input.target_binding_field) {
-        matched_scene = findScene(input.target_host_object, input.target_binding_field);
-    }
-    let matched_template;
-    if (matched_scene) {
-        const templates = getTemplatesByScene(matched_scene.id);
-        if (templates.length > 0)
-            matched_template = templates[0];
-    }
-    let matched_pattern;
-    if (input.intent) {
-        const patterns = matchSemanticPattern(input.intent);
-        if (patterns.length > 0)
-            matched_pattern = patterns[0];
-    }
-    let puzzle_state;
-    let puzzle_completeness;
-    if (input.mode === "initial_design" && input.intent) {
-        puzzle_state = initPuzzleFromIntent({ rule_sentence: input.intent });
-        puzzle_completeness = checkPuzzleCompleteness(puzzle_state);
-    }
-    else if (input.mode === "mid_design_review" && input.guard_json) {
-        puzzle_completeness = checkPuzzleCompleteness({});
-    }
-    const relevant_risks = filterRiskRules(input.mode, input.stakeholder, matched_scene);
-    let risk_assessment;
-    if (input.mode === "pre_publish" && input.guard_json) {
-        const guard_data = input.guard_json.root;
-        risk_assessment = assessGuardRisks({
-            table: guard_data?.table ?? [],
-            root: input.guard_json.root,
-            rely: guard_data?.rely,
-        });
-    }
-    const relevant_checklist = filterChecklist(input.mode);
-    const relevant_questions = filterQuestions(input.mode);
-    const cross_object_refs = buildCrossObjectRefs(matched_scene);
-    const onchain_constraints = buildOnchainConstraints();
-    const rendering_hints = buildRenderingHints(input.mode, max_length);
-    return {
-        version: GUARD_CONTEXT_VERSION,
-        mode: input.mode,
-        stakeholder_perspective: input.stakeholder,
-        matched_scene,
-        matched_template,
-        matched_pattern,
-        puzzle_state,
-        puzzle_completeness,
-        relevant_risks,
-        risk_assessment,
-        relevant_checklist,
-        relevant_questions,
-        cross_object_refs,
-        onchain_constraints,
-        rendering_hints,
-    };
-}
-function filterRiskRules(mode, stakeholder, scene) {
-    let rules = getAllRiskRules();
-    if (scene) {
-        rules = rules.filter(r => !r.id.startsWith("R-X") || true);
-    }
-    if (stakeholder && stakeholder !== "system") {
-    }
-    if (mode === "initial_design") {
-        return rules.filter(r => r.id.startsWith("R-C1") ||
-            r.id.startsWith("R-C4"));
-    }
-    if (mode === "pre_publish") {
-        return rules;
-    }
-    if (mode === "stakeholder_review" && stakeholder) {
-        return rules;
-    }
-    return rules;
-}
-function filterChecklist(mode) {
-    if (mode === "initial_design") {
-        return GUARD_PUBLISH_CHECKLIST.filter(item => ["GC-01", "GC-05", "GC-12"].includes(item.id));
-    }
-    if (mode === "pre_publish") {
-        return GUARD_PUBLISH_CHECKLIST;
-    }
-    return GUARD_PUBLISH_CHECKLIST.filter(item => !item.id.startsWith("GC-0"));
-}
-function filterQuestions(mode) {
-    if (mode === "pre_publish") {
-        return GUARD_CONFIRMATION_QUESTIONS;
-    }
-    if (mode === "mid_design_review") {
-        return GUARD_CONFIRMATION_QUESTIONS.filter(q => q.id === "QG1" || q.id === "QG2");
-    }
-    return [];
-}
-function buildCrossObjectRefs(scene) {
-    const refs = [];
-    for (const machine_scene of MACHINE_SCENES) {
-        refs.push({
-            object: "Machine",
-            field: "Forward.guard",
-            scene_id: machine_scene.id,
-            description: `Machine scene "${machine_scene.id}" can reference Guards via Forward.guard`,
-        });
-    }
-    if (scene && scene.host_object !== "Standalone") {
-        refs.push({
-            object: scene.host_object,
-            field: scene.binding_field,
-            scene_id: scene.id,
-            description: scene.validation_scene,
-        });
-    }
-    return refs;
-}
-function buildOnchainConstraints() {
-    return [
-        { name: "MAX_TABLE_SIZE", value: MAX_TABLE_SIZE, description: "Maximum entries in Guard table" },
-        { name: "MAX_DESCRIPTION_LENGTH", value: MAX_DESCRIPTION_LENGTH, description: "Maximum description length" },
-    ];
-}
-function buildRenderingHints(mode, max_length) {
-    switch (mode) {
-        case "initial_design":
-            return {
-                include_puzzle_template: true,
-                include_risk_details: false,
-                include_questions: false,
-                include_immutability_warning: true,
-                max_length,
-            };
-        case "mid_design_review":
-            return {
-                include_puzzle_template: false,
-                include_risk_details: true,
-                include_questions: false,
-                include_immutability_warning: true,
-                max_length,
-            };
-        case "pre_publish":
-            return {
-                include_puzzle_template: false,
-                include_risk_details: true,
-                include_questions: true,
-                include_immutability_warning: true,
-                max_length,
-            };
-        case "stakeholder_review":
-            return {
-                include_puzzle_template: false,
-                include_risk_details: true,
-                include_questions: false,
-                include_immutability_warning: false,
-                max_length,
-            };
-        default:
-            return {
-                include_puzzle_template: false,
-                include_risk_details: false,
-                include_questions: false,
-                include_immutability_warning: true,
-                max_length,
-            };
-    }
-}
-function findSceneByIntentKeywords(intent) {
-    const lower = intent.toLowerCase();
-    for (const scene of GUARD_SCENES) {
-        if (scene.id.split("_").some(keyword => lower.includes(keyword))) {
-            return scene;
-        }
-    }
-    return undefined;
-}
-export function buildPromptFromGuardContext(bundle) {
-    const lines = [];
-    const h = bundle.rendering_hints;
-    lines.push("═══════════════════════════════════════════════════════════");
-    lines.push(`  GUARD CONTEXT (mode: ${bundle.mode})`);
-    lines.push("═══════════════════════════════════════════════════════════");
-    if (bundle.matched_scene) {
-        lines.push("");
-        lines.push(`Matched Scene: ${bundle.matched_scene.name}`);
-        lines.push(`  Host Object: ${bundle.matched_scene.host_object}`);
-        lines.push(`  Binding Field: ${bundle.matched_scene.binding_field}`);
-        lines.push(`  Validation: ${bundle.matched_scene.validation_scene}`);
-    }
-    if (bundle.matched_template) {
-        lines.push("");
-        lines.push(`Recommended Template: ${bundle.matched_template.name}`);
-        lines.push(`  Patterns: ${bundle.matched_template.recommended_patterns.join(", ")}`);
-    }
-    if (bundle.matched_pattern) {
-        lines.push("");
-        lines.push(`Semantic Pattern: ${bundle.matched_pattern.id} — ${bundle.matched_pattern.pattern_name}`);
-        lines.push(`  Intent: ${bundle.matched_pattern.semantic_intent}`);
-    }
-    if (h.include_puzzle_template && bundle.puzzle_state) {
-        lines.push("");
-        lines.push("─ Puzzle State ──────────────────────────────────────────");
-        const completeness = bundle.puzzle_completeness;
-        if (completeness) {
-            lines.push(`Complete: ${completeness.complete ? "YES" : "NO"}`);
-            if (completeness.missing.length > 0) {
-                lines.push(`Missing: ${completeness.missing.join(", ")}`);
-            }
-        }
-    }
-    if (h.include_risk_details && bundle.relevant_risks.length > 0) {
-        lines.push("");
-        lines.push(`─ Relevant Risk Rules (${bundle.relevant_risks.length}) ──────────────────────`);
-        for (const r of bundle.relevant_risks.slice(0, 5)) {
-            lines.push(`  ${r.id} — ${r.trigger}`);
-        }
-        if (bundle.relevant_risks.length > 5) {
-            lines.push(`  ... and ${bundle.relevant_risks.length - 5} more`);
-        }
-    }
-    if (bundle.risk_assessment) {
-        lines.push("");
-        lines.push("─ Risk Assessment ───────────────────────────────────────");
-        lines.push(`Overall: ${bundle.risk_assessment.overall_risk.toUpperCase()}`);
-        lines.push(`Detected: ${bundle.risk_assessment.risks?.length ?? 0} risks`);
-    }
-    if (h.include_questions && bundle.relevant_questions.length > 0) {
-        lines.push("");
-        lines.push("─ Confirmation Questions ────────────────────────────────");
-        for (const q of bundle.relevant_questions) {
-            lines.push(`  ${q.id} (blocking=${q.blocking}): ${q.question}`);
-        }
-    }
-    if (bundle.cross_object_refs.length > 0) {
-        lines.push("");
-        lines.push("─ Cross-Object References ───────────────────────────────");
-        for (const ref of bundle.cross_object_refs.slice(0, 3)) {
-            lines.push(`  ${ref.object}.${ref.field} (${ref.scene_id})`);
-        }
-    }
-    if (bundle.onchain_constraints.length > 0) {
-        lines.push("");
-        lines.push("─ On-Chain Constraints ──────────────────────────────────");
-        for (const c of bundle.onchain_constraints) {
-            lines.push(`  ${c.name} = ${c.value} (${c.description})`);
-        }
-    }
-    if (h.include_immutability_warning) {
-        lines.push("");
-        lines.push("⚠️  Guard is IMMUTABLE after creation — no update path exists.");
-        lines.push("    Review the validation rule twice before publishing.");
-    }
-    lines.push("");
-    lines.push("═══════════════════════════════════════════════════════════");
-    return lines.join("\n");
-}
-export function getGuardContextSummary(bundle) {
-    const parts = [];
-    parts.push(`Guard Context v${bundle.version}`);
-    parts.push(`Mode: ${bundle.mode}`);
-    if (bundle.matched_scene)
-        parts.push(`Scene: ${bundle.matched_scene.id}`);
-    if (bundle.matched_template)
-        parts.push(`Template: ${bundle.matched_template.id}`);
-    if (bundle.matched_pattern)
-        parts.push(`Pattern: ${bundle.matched_pattern.id}`);
-    parts.push(`Risks: ${bundle.relevant_risks.length} relevant`);
-    parts.push(`Checklist: ${bundle.relevant_checklist.length} items`);
-    parts.push(`Questions: ${bundle.relevant_questions.length}`);
-    parts.push(`Cross-refs: ${bundle.cross_object_refs.length}`);
-    return parts.join(" | ");
-}
+import{GUARD_SCENES,findScene}from'./guard-ledger.js';import{getTemplatesByScene}from'./guard-templates.js';import{matchSemanticPattern}from'./guard-translation.js';import{getAllRiskRules,assessGuardRisks}from'./guard-risk.js';import{initPuzzleFromIntent,checkPuzzleCompleteness}from'./guard-puzzle.js';import{GUARD_PUBLISH_CHECKLIST,GUARD_CONFIRMATION_QUESTIONS}from'./guard-confirm.js';import{MAX_TABLE_SIZE,MAX_DESCRIPTION_LENGTH}from'@wowok/wowok';import{MACHINE_SCENES}from'./machine-ledger.js';export const GUARD_CONTEXT_VERSION='1.0.0';export function buildGuardContext(a){const b=a['max_length']??0xfa0;let c;if(a['intent'])c=findSceneByIntentKeywords(a['intent']);else{if(a['guard_json']?.['binding_scene_id'])c=GUARD_SCENES['find'](o=>o['id']===a['guard_json']['binding_scene_id']);else a['target_host_object']&&a['target_binding_field']&&(c=findScene(a['target_host_object'],a['target_binding_field']));}let d;if(c){const o=getTemplatesByScene(c['id']);if(o['length']>0x0)d=o[0x0];}let e;if(a['intent']){const p=matchSemanticPattern(a['intent']);if(p['length']>0x0)e=p[0x0];}let f,g;if(a['mode']==='initial_design'&&a['intent'])f=initPuzzleFromIntent({'rule_sentence':a['intent']}),g=checkPuzzleCompleteness(f);else a['mode']==='mid_design_review'&&a['guard_json']&&(g=checkPuzzleCompleteness({}));const h=filterRiskRules(a['mode'],a['stakeholder'],c);let i;if(a['mode']==='pre_publish'&&a['guard_json']){const q=a['guard_json']['root'];i=assessGuardRisks({'table':q?.['table']??[],'root':a['guard_json']['root'],'rely':q?.['rely']});}const j=filterChecklist(a['mode']),k=filterQuestions(a['mode']),l=buildCrossObjectRefs(c),m=buildOnchainConstraints(),n=buildRenderingHints(a['mode'],b);return{'version':GUARD_CONTEXT_VERSION,'mode':a['mode'],'stakeholder_perspective':a['stakeholder'],'matched_scene':c,'matched_template':d,'matched_pattern':e,'puzzle_state':f,'puzzle_completeness':g,'relevant_risks':h,'risk_assessment':i,'relevant_checklist':j,'relevant_questions':k,'cross_object_refs':l,'onchain_constraints':m,'rendering_hints':n};}function filterRiskRules(a,b,c){let d=getAllRiskRules();c&&(d=d['filter'](e=>!e['id']['startsWith']('R-X')||!![]));if(b&&b!=='system'){}if(a==='initial_design')return d['filter'](e=>e['id']['startsWith']('R-C1')||e['id']['startsWith']('R-C4'));if(a==='pre_publish')return d;if(a==='stakeholder_review'&&b)return d;return d;}function filterChecklist(a){if(a==='initial_design')return GUARD_PUBLISH_CHECKLIST['filter'](b=>['GC-01','GC-05','GC-12']['includes'](b['id']));if(a==='pre_publish')return GUARD_PUBLISH_CHECKLIST;return GUARD_PUBLISH_CHECKLIST['filter'](b=>!b['id']['startsWith']('GC-0'));}function filterQuestions(a){if(a==='pre_publish')return GUARD_CONFIRMATION_QUESTIONS;if(a==='mid_design_review')return GUARD_CONFIRMATION_QUESTIONS['filter'](b=>b['id']==='QG1'||b['id']==='QG2');return[];}function buildCrossObjectRefs(a){const b=[];for(const c of MACHINE_SCENES){b['push']({'object':'Machine','field':'Forward.guard','scene_id':c['id'],'description':'Machine\x20scene\x20\x22'+c['id']+'\x22\x20can\x20reference\x20Guards\x20via\x20Forward.guard'});}return a&&a['host_object']!=='Standalone'&&b['push']({'object':a['host_object'],'field':a['binding_field'],'scene_id':a['id'],'description':a['validation_scene']}),b;}function buildOnchainConstraints(){return[{'name':'MAX_TABLE_SIZE','value':MAX_TABLE_SIZE,'description':'Maximum\x20entries\x20in\x20Guard\x20table'},{'name':'MAX_DESCRIPTION_LENGTH','value':MAX_DESCRIPTION_LENGTH,'description':'Maximum\x20description\x20length'}];}function buildRenderingHints(a,b){switch(a){case'initial_design':return{'include_puzzle_template':!![],'include_risk_details':![],'include_questions':![],'include_immutability_warning':!![],'max_length':b};case'mid_design_review':return{'include_puzzle_template':![],'include_risk_details':!![],'include_questions':![],'include_immutability_warning':!![],'max_length':b};case'pre_publish':return{'include_puzzle_template':![],'include_risk_details':!![],'include_questions':!![],'include_immutability_warning':!![],'max_length':b};case'stakeholder_review':return{'include_puzzle_template':![],'include_risk_details':!![],'include_questions':![],'include_immutability_warning':![],'max_length':b};default:return{'include_puzzle_template':![],'include_risk_details':![],'include_questions':![],'include_immutability_warning':!![],'max_length':b};}}function findSceneByIntentKeywords(a){const b=a['toLowerCase']();for(const c of GUARD_SCENES){if(c['id']['split']('_')['some'](d=>b['includes'](d)))return c;}return undefined;}export function buildPromptFromGuardContext(a){const b=[],d=a['rendering_hints'];b['push']('═══════════════════════════════════════════════════════════'),b['push']('\x20\x20GUARD\x20CONTEXT\x20(mode:\x20'+a['mode']+')'),b['push']('═══════════════════════════════════════════════════════════');a['matched_scene']&&(b['push'](''),b['push']('Matched\x20Scene:\x20'+a['matched_scene']['name']),b['push']('\x20\x20Host\x20Object:\x20'+a['matched_scene']['host_object']),b['push']('\x20\x20Binding\x20Field:\x20'+a['matched_scene']['binding_field']),b['push']('\x20\x20Validation:\x20'+a['matched_scene']['validation_scene']));a['matched_template']&&(b['push'](''),b['push']('Recommended\x20Template:\x20'+a['matched_template']['name']),b['push']('\x20\x20Patterns:\x20'+a['matched_template']['recommended_patterns']['join'](',\x20')));a['matched_pattern']&&(b['push'](''),b['push']('Semantic\x20Pattern:\x20'+a['matched_pattern']['id']+'\x20—\x20'+a['matched_pattern']['pattern_name']),b['push']('\x20\x20Intent:\x20'+a['matched_pattern']['semantic_intent']));if(d['include_puzzle_template']&&a['puzzle_state']){b['push'](''),b['push']('─\x20Puzzle\x20State\x20──────────────────────────────────────────');const e=a['puzzle_completeness'];e&&(b['push']('Complete:\x20'+(e['complete']?'YES':'NO')),e['missing']['length']>0x0&&b['push']('Missing:\x20'+e['missing']['join'](',\x20')));}if(d['include_risk_details']&&a['relevant_risks']['length']>0x0){b['push'](''),b['push']('─\x20Relevant\x20Risk\x20Rules\x20('+a['relevant_risks']['length']+')\x20──────────────────────');for(const f of a['relevant_risks']['slice'](0x0,0x5)){b['push']('\x20\x20'+f['id']+'\x20—\x20'+f['trigger']);}a['relevant_risks']['length']>0x5&&b['push']('\x20\x20...\x20and\x20'+(a['relevant_risks']['length']-0x5)+'\x20more');}a['risk_assessment']&&(b['push'](''),b['push']('─\x20Risk\x20Assessment\x20───────────────────────────────────────'),b['push']('Overall:\x20'+a['risk_assessment']['overall_risk']['toUpperCase']()),b['push']('Detected:\x20'+(a['risk_assessment']['risks']?.['length']??0x0)+'\x20risks'));if(d['include_questions']&&a['relevant_questions']['length']>0x0){b['push'](''),b['push']('─\x20Confirmation\x20Questions\x20────────────────────────────────');for(const g of a['relevant_questions']){b['push']('\x20\x20'+g['id']+'\x20(blocking='+g['blocking']+'):\x20'+g['question']);}}if(a['cross_object_refs']['length']>0x0){b['push'](''),b['push']('─\x20Cross-Object\x20References\x20───────────────────────────────');for(const i of a['cross_object_refs']['slice'](0x0,0x3)){b['push']('\x20\x20'+i['object']+'.'+i['field']+'\x20('+i['scene_id']+')');}}if(a['onchain_constraints']['length']>0x0){b['push'](''),b['push']('─\x20On-Chain\x20Constraints\x20──────────────────────────────────');for(const j of a['onchain_constraints']){b['push']('\x20\x20'+j['name']+'\x20=\x20'+j['value']+'\x20('+j['description']+')');}}return d['include_immutability_warning']&&(b['push'](''),b['push']('⚠️\x20\x20Guard\x20is\x20IMMUTABLE\x20after\x20creation\x20—\x20no\x20update\x20path\x20exists.'),b['push']('\x20\x20\x20\x20Review\x20the\x20validation\x20rule\x20twice\x20before\x20publishing.')),b['push'](''),b['push']('═══════════════════════════════════════════════════════════'),b['join']('\x0a');}export function getGuardContextSummary(a){const b=[];b['push']('Guard\x20Context\x20v'+a['version']),b['push']('Mode:\x20'+a['mode']);if(a['matched_scene'])b['push']('Scene:\x20'+a['matched_scene']['id']);if(a['matched_template'])b['push']('Template:\x20'+a['matched_template']['id']);if(a['matched_pattern'])b['push']('Pattern:\x20'+a['matched_pattern']['id']);return b['push']('Risks:\x20'+a['relevant_risks']['length']+'\x20relevant'),b['push']('Checklist:\x20'+a['relevant_checklist']['length']+'\x20items'),b['push']('Questions:\x20'+a['relevant_questions']['length']),b['push']('Cross-refs:\x20'+a['cross_object_refs']['length']),b['join']('\x20|\x20');}