@gramatr/mcp 0.7.10 → 0.7.13

package/dist/hooks/lib/intelligence.js

@@ -1,43 +1,65 @@
+function toAgentHint(agent) {
+    if (!agent || typeof agent !== 'object')
+        return null;
+    const a = agent;
+    const displayName = typeof a.display_name === 'string'
+        ? a.display_name
+        : typeof a.displayName === 'string'
+            ? a.displayName
+            : null;
+    const model = typeof a.model === 'string'
+        ? a.model
+        : typeof a.model_preference === 'string'
+            ? a.model_preference
+            : null;
+    return {
+        name: typeof a.name === 'string' ? a.name : null,
+        display_name: displayName,
+        model,
+        reason: typeof a.reason === 'string' ? a.reason : null,
+    };
+}
+function hasAgentIdentity(hint) {
+    return !!hint && !!(hint.name || hint.display_name || hint.model || hint.reason);
+}
+function toRecommendationMeta(value) {
+    if (!value || typeof value !== 'object')
+        return null;
+    const r = value;
+    return {
+        type: typeof r.type === 'string' ? r.type : null,
+        source: typeof r.source === 'string' ? r.source : null,
+        confidence: typeof r.confidence === 'number' ? r.confidence : null,
+    };
+}
+function renderContractBlock(payload) {
+    return ['```json', JSON.stringify(payload, null, 2), '```'].join('\n');
+}
+function cloneContractPayload(payload) {
+    return JSON.parse(JSON.stringify(payload));
+}
 export function formatFailureWarning(failure) {
-    const lines = [];
-    lines.push('⚠️ [gramatr intelligence — failed]');
-    lines.push('');
-    switch (failure.reason) {
-        case 'auth':
-            lines.push('🔒 AUTHENTICATION FAILURE — gramatr decision router cannot authenticate.');
-            lines.push(`Detail: ${failure.detail}`);
-            lines.push('');
-            lines.push('FIX: Set GRAMATR_TOKEN in your environment (AIOS_MCP_TOKEN remains a legacy alias)');
-            lines.push('Without this, NO pre-classification happens. The Algorithm runs without intelligence.');
-            break;
-        case 'timeout':
-            lines.push('⏱️ TIMEOUT — gramatr decision router did not respond in time.');
-            lines.push(`Detail: ${failure.detail}`);
-            lines.push('');
-            lines.push('The classifier may be overloaded or the server may be slow.');
-            break;
-        case 'server_down':
-            lines.push('🔴 SERVER UNREACHABLE — cannot connect to gramatr server.');
-            lines.push(`Detail: ${failure.detail}`);
-            lines.push('');
-            lines.push('Check: Is the server running? Is the URL correct? Is there a network issue?');
-            break;
-        case 'server_error':
-            lines.push('💥 SERVER ERROR — gramatr server returned an error.');
-            lines.push(`Detail: ${failure.detail}`);
-            break;
-        case 'parse_error':
-            lines.push('🔧 PARSE ERROR — could not understand the server response.');
-            lines.push(`Detail: ${failure.detail}`);
-            break;
-        default:
-            lines.push('❓ UNKNOWN ERROR — gramatr enrichment failed.');
-            lines.push(`Detail: ${failure.detail}`);
-    }
-    lines.push('');
-    lines.push('IMPORTANT: Tell the user about this error. Do not silently proceed without intelligence.');
-    lines.push('You should still follow the Algorithm from CLAUDE.md, but note that pre-classification is unavailable.');
-    return lines.join('\n');
+    const titleMap = {
+        auth: 'AUTHENTICATION FAILURE',
+        timeout: 'TIMEOUT',
+        server_down: 'SERVER UNREACHABLE',
+        server_error: 'SERVER ERROR',
+        parse_error: 'PARSE ERROR',
+        unknown: 'UNKNOWN ERROR',
+    };
+    return renderContractBlock({
+        schema: 'gmtr.intelligence.error.v1',
+        error: {
+            reason: failure.reason,
+            title: titleMap[failure.reason],
+            detail: failure.detail,
+        },
+        required_actions: [
+            'Tell the user intelligence pre-classification failed.',
+            'Do not pretend intelligence packet delivery succeeded.',
+            'Continue with degraded flow only after surfacing the failure.',
+        ],
+    });
 }
 export function mergeEnrichmentIntoRoute(route, enrichment) {
     const packet2 = enrichment?.packet_2 || enrichment;
@@ -63,400 +85,180 @@ function normalizeClassifierHeadScores(value) {
         return [];
     return Array.isArray(value) ? value : [value];
 }
+function normalizeMatchedSkillNames(packet1, classification) {
+    const fromClassification = Array.isArray(classification.matched_skills)
+        ? classification.matched_skills.filter((skill) => typeof skill === 'string')
+        : [];
+    if (fromClassification.length > 0)
+        return fromClassification;
+    const matched = packet1.skills?.routing?.matched_skills || [];
+    return matched
+        .map((skill) => skill.name || skill.id)
+        .filter((name) => typeof name === 'string');
+}
+function normalizeRoutingSignals(value) {
+    if (!value || typeof value !== 'object')
+        return null;
+    const raw = value;
+    const { bert_entity_scope, bert_entity_category, bert_entity_type_suggestion, classifier_entity_scope, classifier_entity_category, classifier_entity_type_suggestion, ...rest } = raw;
+    return {
+        ...rest,
+        classifier_entity_scope: classifier_entity_scope ?? bert_entity_scope ?? null,
+        classifier_entity_category: classifier_entity_category ?? bert_entity_category ?? null,
+        classifier_entity_type_suggestion: classifier_entity_type_suggestion ?? bert_entity_type_suggestion ?? null,
+    };
+}
+function normalizeClassifierSignals(classifierHeads, routingSignals) {
+    const normalizedHeads = classifierHeads
+        ? Object.fromEntries(Object.entries(classifierHeads).map(([head, value]) => [
+            head,
+            normalizeClassifierHeadScores(value),
+        ]))
+        : null;
+    const entityClassification = {
+        scope: routingSignals?.classifier_entity_scope ?? null,
+        category: routingSignals?.classifier_entity_category ?? null,
+        type_suggestion: routingSignals?.classifier_entity_type_suggestion ?? null,
+    };
+    if (!normalizedHeads && !entityClassification.scope && !entityClassification.category && !entityClassification.type_suggestion) {
+        return null;
+    }
+    return {
+        heads: normalizedHeads,
+        entity_classification: entityClassification,
+    };
+}
+function buildRequiredActions(packet2Status, enrichmentId) {
+    return packet2Status === 'required' && enrichmentId
+        ? [`Call gramatr_get_packet_two with enrichment_id="${enrichmentId}" before proceeding.`]
+        : [];
+}
+function normalizeFullContractPayload(data) {
+    const payload = cloneContractPayload(data);
+    const packet1 = (payload.packet_1 || {});
+    const manifest = (packet1.manifest || {});
+    const unifiedPacket = (payload.unified_packet || null);
+    const packet2 = (payload.packet_2 || {});
+    const packet2Status = manifest.packet_2_status
+        || packet2.status
+        || payload.packet_2_status
+        || 'not_applicable';
+    const enrichmentId = manifest.enrichment_id
+        || packet2.enrichment_id
+        || payload.enrichment_id
+        || null;
+    const packet1RoutingSignals = normalizeRoutingSignals(packet1.routing_signals);
+    if (packet1RoutingSignals) {
+        packet1.routing_signals = packet1RoutingSignals;
+    }
+    const packet1ClassifierHeads = packet1.classifier_heads;
+    const packet1ClassifierSignals = normalizeClassifierSignals(packet1ClassifierHeads, packet1RoutingSignals);
+    if (packet1ClassifierSignals) {
+        packet1.classifier_signals = packet1ClassifierSignals;
+    }
+    if (unifiedPacket) {
+        const unifiedRoutingSignals = normalizeRoutingSignals(unifiedPacket.routing_signals);
+        if (unifiedRoutingSignals) {
+            unifiedPacket.routing_signals = unifiedRoutingSignals;
+        }
+        const unifiedClassifierSignals = normalizeClassifierSignals(packet1ClassifierHeads, unifiedRoutingSignals);
+        if (unifiedClassifierSignals) {
+            unifiedPacket.classifier_signals = unifiedClassifierSignals;
+        }
+    }
+    if (Object.keys(packet2).length > 0) {
+        packet2.fetch_tool = packet2.fetch_tool || 'gramatr_get_packet_two';
+        packet2.required = packet2.required ?? (packet2Status === 'required');
+        packet2.enrichment_id = packet2.enrichment_id ?? enrichmentId;
+    }
+    payload.required_actions = buildRequiredActions(packet2Status, enrichmentId);
+    return payload;
+}
 export function formatIntelligence(data, enrichment) {
+    if (data.schema === 'gmtr.intelligence.unified.v1' || data.contract_shape === 'full' || data.unified_packet) {
+        return renderContractBlock(normalizeFullContractPayload(data));
+    }
     const packet1 = data.packet_1 || {};
     const manifest = packet1.manifest;
-    const packet1Contents = manifest?.contents || data.packet_1_contents;
-    const packet2Contents = manifest?.packet_2_contents || data.packet_2_contents;
-    const packet2Status = manifest?.packet_2_status || data.packet_2_status;
-    const enrichmentId = manifest?.enrichment_id ?? data.enrichment_id;
+    const packet2Status = manifest?.packet_2_status || data.packet_2_status || 'not_applicable';
+    const enrichmentId = manifest?.enrichment_id ?? data.enrichment_id ?? null;
     const c = packet1.classification || data.classification || {};
-    const ts = packet1.token_savings || data.token_savings || {};
     const es = packet1.execution_summary || data.execution_summary || {};
-    const lines = [];
-    lines.push(`[gramatr intelligence — pre-classified by ${es.classifier_model || 'gramatr'}]`);
-    const ps = packet1.project_state || data.project_state;
-    if (ps && ps.project_id) {
-        lines.push('');
-        lines.push('ACTIVE PROJECT STATE:');
-        if (ps.active_prd_title) {
-            lines.push(`  PRD: ${ps.active_prd_title}${ps.active_prd_id ? ` (${ps.active_prd_id})` : ''}`);
-        }
-        if (ps.current_phase) {
-            lines.push(`  Phase: ${ps.current_phase}`);
-        }
-        if (ps.isc_summary && ps.isc_summary.total && ps.isc_summary.total > 0) {
-            const s = ps.isc_summary;
-            lines.push(`  ISC: ${s.passing || 0}/${s.total} passing, ${s.failing || 0} failing, ${s.pending || 0} pending`);
-        }
-        if (ps.session_history_summary) {
-            lines.push(`  Last session: "${ps.session_history_summary}"`);
-        }
-        if (ps.current_phase && ps.current_phase !== 'OBSERVE') {
-            lines.push(`  ⚠️ RESUME from ${ps.current_phase} phase — do NOT restart OBSERVE`);
-        }
-        lines.push('');
-    }
-    const meta = [];
-    if (c.effort_level)
-        meta.push(`Effort: ${c.effort_level}`);
-    if (c.intent_type)
-        meta.push(`Intent: ${c.intent_type}`);
-    if (c.confidence)
-        meta.push(`Confidence: ${Math.round(c.confidence * 100)}%`);
-    if (c.memory_scope)
-        meta.push(`Scope: ${c.memory_scope}`);
-    if (meta.length)
-        lines.push(meta.join(' | '));
-    if (c.matched_skills?.length) {
-        lines.push(`Matched skills: ${c.matched_skills.join(', ')}`);
-    }
-    const re = c.reverse_engineering;
-    if (re) {
-        if (re.explicit_wants?.length) {
-            lines.push('What user explicitly wants:');
-            for (const w of re.explicit_wants)
-                lines.push(`  - ${w}`);
-        }
-        if (re.implicit_wants?.length) {
-            lines.push('What is implied but not stated:');
-            for (const w of re.implicit_wants)
-                lines.push(`  - ${w}`);
-        }
-        if (re.explicit_dont_wants?.length) {
-            lines.push('What user explicitly does NOT want:');
-            for (const w of re.explicit_dont_wants)
-                lines.push(`  - ${w}`);
-        }
-        if (re.implicit_dont_wants?.length) {
-            lines.push('What user would clearly NOT want:');
-            for (const w of re.implicit_dont_wants)
-                lines.push(`  - ${w}`);
-        }
-        if (re.gotchas?.length) {
-            lines.push('Gotchas and edge cases:');
-            for (const g of re.gotchas)
-                lines.push(`  - ${g}`);
-        }
-    }
-    if (c.suggested_capabilities?.length) {
-        lines.push(`Suggested capabilities: ${c.suggested_capabilities.join(', ')}`);
-    }
-    if (c.isc_scaffold?.length) {
-        lines.push('ISC Scaffold (preliminary Ideal State Criteria):');
-        for (let i = 0; i < c.isc_scaffold.length; i++) {
-            lines.push(`  ${i + 1}. ${c.isc_scaffold[i]}`);
-        }
-    }
-    if (c.constraints_extracted?.length) {
-        lines.push(`Constraints: ${c.constraints_extracted.join('; ')}`);
-    }
-    const audit = packet1.capability_audit || data.capability_audit;
-    if (audit?.formatted_summary) {
-        lines.push('');
-        lines.push(audit.formatted_summary);
-    }
-    const qg = packet1.quality_gate_config || data.quality_gate_config;
-    if (qg?.rules?.length) {
-        lines.push('');
-        lines.push(`ISC Quality Gate: min ${qg.min_criteria || 4} criteria, ${qg.anti_required ? 'anti-criteria required' : 'anti-criteria optional'}, ${qg.word_range?.min || 8}-${qg.word_range?.max || 12} words each`);
-        const effortGated = qg.rules.filter((r) => r.min_effort);
-        if (effortGated.length) {
-            lines.push(`  Effort-gated rules: ${effortGated.map((r) => `${r.id} (${r.min_effort}+)`).join(', ')}`);
-        }
-    }
-    const preload = packet1.context_pre_load_plan || data.context_pre_load_plan;
-    if (preload?.entity_types?.length) {
-        lines.push(`Context pre-load: ${preload.entity_types.join(', ')}`);
-    }
-    const memoryPlan = packet1.memory_plan || data.memory_plan;
-    if (memoryPlan?.strategy) {
-        lines.push(`Memory plan: strategy=${memoryPlan.strategy}${memoryPlan.memory_scope ? ` | scope=${memoryPlan.memory_scope}` : ''}${memoryPlan.domain_class ? ` | domain=${memoryPlan.domain_class}` : ''}${memoryPlan.entity_type_filter ? ` | filter=${memoryPlan.entity_type_filter}` : ''}${typeof memoryPlan.top_k === 'number' ? ` | top_k=${memoryPlan.top_k}` : ''}`);
-    }
-    const directives = packet1.behavioral_directives || data.behavioral_directives;
-    if (directives?.length) {
-        lines.push('');
-        lines.push('BEHAVIORAL DIRECTIVES (from gramatr steering rules — follow these):');
-        for (const d of directives)
-            lines.push(`  - ${d}`);
-    }
-    if (packet1Contents?.length || packet2Contents?.length || packet2Status || enrichmentId) {
-        lines.push('');
-        if (packet1Contents?.length) {
-            lines.push(`PACKET 1 CONTENTS: ${packet1Contents.join(', ')}`);
-        }
-        const packet2Parts = [
-            packet2Status ? `status=${packet2Status}` : '',
-            packet2Contents?.length ? `contents=${packet2Contents.join(', ')}` : '',
-            enrichmentId ? `enrichment_id=${enrichmentId}` : '',
-        ].filter(Boolean);
-        if (packet2Parts.length) {
-            lines.push(`PACKET 2: ${packet2Parts.join(' | ')}`);
-        }
-    }
-    const formatSpec = packet1.format_spec || data.format_spec;
-    if (formatSpec?.mode || formatSpec?.phases?.length || formatSpec?.response_contract?.length) {
-        lines.push('');
-        lines.push(`FORMAT SPEC: ${[
-            formatSpec.mode ? `mode=${formatSpec.mode}` : '',
-            formatSpec.phases?.length ? `phases=${formatSpec.phases.join('→')}` : '',
-            formatSpec.response_contract?.length ? `contract=${formatSpec.response_contract.join(', ')}` : '',
-        ].filter(Boolean).join(' | ')}`);
-    }
-    const classifierHeads = packet1.classifier_heads || data.classifier_heads;
-    if (classifierHeads) {
-        const entries = Object.entries(classifierHeads).slice(0, 4);
-        if (entries.length) {
-            lines.push('');
-            lines.push('CLASSIFIER HEADS:');
-            for (const [head, rawScores] of entries) {
-                const top = normalizeClassifierHeadScores(rawScores)
-                    .slice(0, 2)
-                    .map((score) => {
-                    const numericScore = typeof score.score === 'number'
-                        ? score.score
-                        : typeof score.confidence === 'number'
-                            ? score.confidence
-                            : null;
-                    const pct = typeof numericScore === 'number' ? `${Math.round(numericScore * 100)}%` : '';
-                    return [score.label, pct].filter(Boolean).join(' ');
-                })
-                    .filter(Boolean)
-                    .join(', ');
-                lines.push(`  - ${head}: ${top || 'present'}`);
-            }
-        }
-    }
-    const routingSignals = packet1.routing_signals || data.routing_signals;
-    if (routingSignals) {
-        const parts = [
-            routingSignals.complexity ? `complexity=${routingSignals.complexity}` : '',
-            routingSignals.crud_operation ? `crud=${routingSignals.crud_operation}` : '',
-            routingSignals.conversation_phase ? `phase=${routingSignals.conversation_phase}` : '',
-            routingSignals.memory_scope ? `scope=${routingSignals.memory_scope}` : '',
-            routingSignals.memory_priority ? `memory=${routingSignals.memory_priority}` : '',
-            typeof routingSignals.retrieval_needed === 'boolean' ? `retrieval=${routingSignals.retrieval_needed}` : '',
-            typeof routingSignals.is_read_only === 'boolean' ? `read_only=${routingSignals.is_read_only}` : '',
-            typeof routingSignals.requires_approval === 'boolean' ? `approval=${routingSignals.requires_approval}` : '',
-            typeof routingSignals.escalation_recommended === 'boolean' ? `escalate=${routingSignals.escalation_recommended}` : '',
-        ].filter(Boolean);
-        if (parts.length || routingSignals.safety_flags?.length) {
-            lines.push('');
-            lines.push(`ROUTING SIGNALS: ${parts.join(' | ')}`);
-            if (routingSignals.entity_type_suggestion?.top) {
-                lines.push(`  Entity suggestion: ${routingSignals.entity_type_suggestion.top}`);
-            }
-            if (routingSignals.safety_flags?.length) {
-                lines.push(`  Safety flags: ${routingSignals.safety_flags.join(', ')}`);
-            }
-        }
-    }
-    const skillRouting = packet1.skills?.routing || packet1.skill_routing || data.skill_routing;
-    if (skillRouting) {
-        const matched = (skillRouting.matched_skills || []).map((skill) => skill.name || skill.id).filter(Boolean);
-        const stats = [
-            typeof skillRouting.use_count === 'number' ? `use=${skillRouting.use_count}` : '',
-            typeof skillRouting.decline_count === 'number' ? `decline=${skillRouting.decline_count}` : '',
-            typeof skillRouting.na_count === 'number' ? `na=${skillRouting.na_count}` : '',
-            typeof skillRouting.pattern_boost_applied === 'boolean' ? `pattern_boost=${skillRouting.pattern_boost_applied}` : '',
-        ].filter(Boolean);
-        if (matched.length || stats.length) {
-            lines.push('');
-            if (matched.length)
-                lines.push(`SKILL ROUTING: ${matched.join(', ')}`);
-            if (stats.length)
-                lines.push(`  Stats: ${stats.join(' | ')}`);
-        }
-    }
-    const activeSkill = packet1.skills?.active || packet1.active_skill || data.active_skill;
-    if (activeSkill?.directives?.length) {
-        lines.push('');
-        lines.push(`ACTIVE SKILL: ${activeSkill.title || activeSkill.name} (phase: ${activeSkill.phase || 'ALL'})`);
-        for (const d of activeSkill.directives)
-            lines.push(`  - ${d}`);
-    }
-    const rules = packet1.behavioral_rules || data.behavioral_rules;
-    const effort = c.effort_level || 'standard';
-    const routingMemoryPlan = packet1.memory_plan || data.memory_plan;
-    const memoryScope = c.memory_scope || routingSignals?.memory_scope || null;
-    if (rules) {
-        lines.push('');
-        lines.push(`ALGORITHM: ${(rules.algorithm_phases || []).join(' → ')}`);
-        if (rules.hard_gates) {
-            lines.push('');
-            lines.push('HARD GATES:');
-            for (const value of Object.values(rules.hard_gates)) {
-                lines.push(`  - ${value}`);
-            }
-        }
-        if (rules.verification_rules?.length) {
-            lines.push('');
-            lines.push('VERIFICATION RULES:');
-            for (const r of rules.verification_rules)
-                lines.push(`  - ${r}`);
-        }
-        if (rules.code_rules?.length) {
-            lines.push('');
-            lines.push('CODE RULES:');
-            for (const r of rules.code_rules)
-                lines.push(`  - ${r}`);
-        }
-        if (rules.safety_rules?.length) {
-            lines.push('');
-            lines.push('SAFETY RULES:');
-            for (const r of rules.safety_rules)
-                lines.push(`  - ${r}`);
-        }
-    }
-    if (routingMemoryPlan?.semantic_search_enabled || memoryScope) {
-        lines.push('');
-        lines.push('═══ MANDATORY: QUERY GRAMATR MEMORY BEFORE ANY WORK ═══');
-        lines.push(`${memoryScope ? `Memory scope: ${memoryScope} | ` : ''}Use search_results from Packet 1 first. Only call search_semantic for follow-up queries beyond the returned packet.`);
-        lines.push('Do NOT answer from stale local markdown alone. gramatr has the live knowledge graph.');
-    }
-    lines.push('');
-    lines.push('═══ MANDATORY: CREATE ISC VIA TaskCreate BEFORE ANY WORK ═══');
-    lines.push('You MUST call the TaskCreate tool for each criterion below. This creates visible tracked tasks.');
-    lines.push('NEVER write criteria as manual text/tables. ALWAYS use TaskCreate + TaskList tools.');
-    lines.push('ALWAYS prefix task subjects with "ISC-C{N}: " for criteria or "ISC-A{N}: " for anti-criteria.');
-    lines.push('The ISC prefix is REQUIRED — it signals to the user that gramatr intelligence is driving the criteria.');
-    lines.push('This is a HARD GATE — do NOT proceed to any work until TaskCreate calls are complete.');
-    lines.push('');
-    lines.push('When presenting gramatr intelligence (ISC scaffolds, search results, agent recommendations, summaries), prefix with **grā:** in bold. This distinguishes server-pre-computed content from your own reasoning. Example: "**grā:** ISC scaffold suggests 6 criteria for this migration task."');
-    if (effort === 'instant') {
-        lines.push('');
-        lines.push('FORMAT (instant effort — minimal): State, do, confirm.');
-    }
-    else if (effort === 'fast') {
-        lines.push('');
-        lines.push('FORMAT (fast effort — compressed):');
-        lines.push('  1. "Understanding: [wants] | Avoiding: [don\'t wants]"');
-        if (c.isc_scaffold?.length) {
-            lines.push('  2. MANDATORY — call TaskCreate for each:');
-            for (let i = 0; i < c.isc_scaffold.length; i++) {
-                lines.push(`     [INVOKE TaskCreate: subject="ISC-C${i + 1}: ${c.isc_scaffold[i]}", description="Binary testable: PASS or FAIL."]`);
-            }
-            lines.push('  3. [INVOKE TaskList to display criteria to user]');
-            lines.push('  4. Do the work');
-            lines.push('  5. [INVOKE TaskList], then [INVOKE TaskUpdate] each with PASS/FAIL + evidence');
-        }
-        else {
-            lines.push('  2. [INVOKE TaskCreate for at least 4 criteria you identify]');
-            lines.push('  3. [INVOKE TaskList to display criteria to user]');
-            lines.push('  4. Do the work');
-            lines.push('  5. [INVOKE TaskList], then [INVOKE TaskUpdate] each with PASS/FAIL + evidence');
-        }
-    }
-    else {
-        lines.push('');
-        lines.push(`FORMAT (${effort} effort — full phases)`);
-        const agents = packet1.agents?.suggested || packet1.suggested_agents || data.packet_2?.agents?.suggested || data.packet_2?.suggested_agents || data.suggested_agents;
-        if (agents?.length) {
-            lines.push('');
-            lines.push('Suggested agents:');
-            for (const a of agents) {
-                lines.push(`  - ${a.display_name || a.name || 'agent'} (${a.model || 'default'}) — ${a.reason || ''}`);
-            }
-        }
-    }
-    const mem = packet1.memory_context || data.memory_context;
-    if (mem?.results?.length) {
-        lines.push('');
-        lines.push(`RELEVANT MEMORY (${mem.total_count} matches from gramatr knowledge graph):`);
-        for (const r of mem.results.slice(0, 5)) {
-            const sim = r.similarity ? ` (${Math.round(r.similarity * 100)}% match)` : '';
-            lines.push(`  - [${r.entity_type || 'unknown'}] ${r.entity_name || 'unnamed'}${sim}: ${((r.summary || r.content) || '').substring(0, 150)}`);
-        }
-    }
+    const routingSignals = normalizeRoutingSignals(packet1.routing_signals || data.routing_signals);
+    const classifierHeads = (packet1.classifier_heads || data.classifier_heads);
+    const classifierSignals = normalizeClassifierSignals(classifierHeads, routingSignals);
+    const memory = packet1.memory_context || data.memory_context;
     const searchResults = packet1.search_results || data.search_results;
-    if (searchResults?.results?.length) {
-        lines.push('');
-        lines.push(`SEARCH RESULTS (${searchResults.count || searchResults.results.length} pre-loaded):`);
-        for (const r of searchResults.results.slice(0, 3)) {
-            const label = [r.entity_name, r.entity_type].filter(Boolean).join(' / ');
-            lines.push(`  - ${[label, ((r.summary || r.snippet) || '').substring(0, 150)].filter(Boolean).join(': ')}`);
-        }
-    }
-    const diaryCompact = packet1.diary_compact || data.diary_compact;
-    if (diaryCompact?.summary || diaryCompact?.current_focus) {
-        lines.push('');
-        lines.push('DIARY COMPACT:');
-        if (diaryCompact.summary)
-            lines.push(`  ${diaryCompact.summary}`);
-        if (diaryCompact.current_focus)
-            lines.push(`  Focus: ${diaryCompact.current_focus}`);
-    }
-    const agentRecommendation = packet1.agents?.recommendation || packet1.agent_recommendation || data.agent_recommendation;
-    if (agentRecommendation?.type || agentRecommendation?.source) {
-        lines.push('');
-        lines.push(`AGENT RECOMMENDATION: ${[
-            agentRecommendation.type ? `type=${agentRecommendation.type}` : '',
-            agentRecommendation.source ? `source=${agentRecommendation.source}` : '',
-            typeof agentRecommendation.confidence === 'number'
-                ? `confidence=${Math.round(agentRecommendation.confidence * 100)}%`
-                : '',
-        ].filter(Boolean).join(' | ')}`);
-    }
-    const activeTask = packet1.active_task || data.active_task;
-    if (activeTask?.id || activeTask?.title || activeTask?.phase || activeTask?.status) {
-        lines.push('');
-        lines.push(`ACTIVE TASK: ${[
-            activeTask.id ? `id=${activeTask.id}` : '',
-            activeTask.title ? `title=${activeTask.title}` : '',
-            activeTask.phase ? `phase=${activeTask.phase}` : '',
-            activeTask.status ? `status=${activeTask.status}` : '',
-        ].filter(Boolean).join(' | ')}`);
-    }
-    const composed = packet1.agents?.composed || packet1.composed_agents || data.composed_agents;
-    if (composed?.length) {
-        lines.push('');
-        lines.push('gramatr composed agent (specialized for this task — USE THIS):');
-        for (const ca of composed) {
-            lines.push(`  Agent: ${ca.display_name || ca.name || 'specialist'}`);
-            lines.push(`  Domain: ${ca.task_domain || 'general'} | Expertise: ${(ca.expertise_areas || []).join(', ')}`);
-            lines.push(`  Model: ${ca.model_preference || 'default'}`);
-            lines.push(`  Context: ${ca.context_summary || 'memory-aware'}`);
-            lines.push('  ACTION: Use the Task tool with subagent_type="general-purpose" and inject this system prompt:');
-            lines.push('  --- AGENT SYSTEM PROMPT START ---');
-            const promptPreview = (ca.system_prompt || '').substring(0, 800);
-            lines.push(`  ${promptPreview}${(ca.system_prompt || '').length > 800 ? '... [truncated — use gramatr_invoke_agent for full prompt]' : ''}`);
-            lines.push('  --- AGENT SYSTEM PROMPT END ---');
-        }
-    }
-    const saved = ts.total_saved || ts.tokens_saved || 0;
-    if (saved > 0) {
-        lines.push(`[Token savings: ${saved.toLocaleString()} tokens saved per request (CLAUDE.md: ${(ts.claude_md_reduction || 0).toLocaleString()}, OBSERVE offload: ${(ts.observe_work_offloaded || 0).toLocaleString()})]`);
-    }
-    const curatedContext = packet1.curated_context || data.curated_context;
-    if (curatedContext) {
-        lines.push('');
-        lines.push('CURATED CONTEXT:');
-        lines.push(curatedContext.trim());
-    }
-    const diagnostics = packet1.packet_diagnostics || data.packet_diagnostics;
-    if (diagnostics?.memory_context?.status === 'error' || diagnostics?.project_state?.status === 'error') {
-        lines.push('');
-        lines.push('PACKET DIAGNOSTICS:');
-        if (diagnostics.memory_context?.status === 'error') {
-            lines.push(`  - Memory pre-load degraded: ${diagnostics.memory_context.error || 'unknown error'}`);
-        }
-        if (diagnostics.project_state?.status === 'error') {
-            lines.push(`  - Project state degraded: ${diagnostics.project_state.error || 'unknown error'}`);
-        }
-    }
-    const degraded = es.degraded_components?.filter((component) => component.startsWith('classification.')) || [];
-    if (degraded.length > 0) {
-        lines.push('');
-        lines.push('CLASSIFIER DIAGNOSTICS:');
-        for (const component of degraded) {
-            lines.push(`  - ${component.replace('classification.', '').replace(/_/g, ' ')} degraded`);
-        }
-    }
-    if (!enrichment && packet2Status === 'required' && enrichmentId) {
-        lines.push('');
-        lines.push(`Packet 2 (reverse engineering + ISC scaffold) is required but still generating. Call gramatr_get_enrichment with enrichment_id="${enrichmentId}" before proceeding.`);
-    }
-    return lines.join('\n');
+    const agentRecommendation = packet1.agents?.recommendation || packet1.agent_recommendation || data.agent_recommendation || null;
+    const suggestedAgents = packet1.agents?.suggested || packet1.suggested_agents || data.suggested_agents || [];
+    const selectedAgent = suggestedAgents[0] || null;
+    const recommendationHint = toAgentHint(agentRecommendation);
+    const selectedHint = toAgentHint(selectedAgent);
+    const recommendationMeta = toRecommendationMeta(agentRecommendation);
+    const matchedSkillNames = normalizeMatchedSkillNames(packet1, c);
+    const activeSkill = packet1.skills?.active?.name || packet1.active_skill?.name || null;
+    const skillStats = packet1.skills?.routing
+        ? {
+            use_count: packet1.skills.routing.use_count ?? null,
+            decline_count: packet1.skills.routing.decline_count ?? null,
+            na_count: packet1.skills.routing.na_count ?? null,
+        }
+        : null;
+    const envelope = {
+        schema: 'gmtr.intelligence.envelope.v1',
+        source: 'gramatr',
+        consumer_instructions: {
+            protocol: 'Process packet_1 first. Treat packet_1 as deterministic contract input.',
+            packet_1: [
+                'Use classification + routing_signals to decide immediate response mode.',
+                'Use memory_context/search_results directly; do not re-summarize with LLM in packet one.',
+                'Execute required_actions exactly when present.',
+            ],
+            packet_2: [
+                'If packet_2.required is true, call fetch_tool with enrichment_id before deep reasoning.',
+                'Merge packet_2 reasoning into your plan, then continue implementation.',
+            ],
+        },
+        packet_1: {
+            manifest: {
+                packet_2_status: packet2Status,
+                packet_2_required: packet2Status === 'required',
+                enrichment_id: enrichmentId,
+            },
+            classification: {
+                effort_level: c.effort_level || null,
+                intent_type: c.intent_type || null,
+                confidence: c.confidence ?? null,
+                memory_scope: c.memory_scope || routingSignals?.memory_scope || null,
+                matched_skills: matchedSkillNames,
+                constraints_extracted: c.constraints_extracted || [],
+            },
+            routing_signals: routingSignals || null,
+            classifier_signals: classifierSignals,
+            memory_context: memory || null,
+            search_results: searchResults || null,
+            skills: {
+                active: activeSkill,
+                matched: matchedSkillNames,
+                stats: skillStats,
+            },
+            agents: {
+                recommendation: hasAgentIdentity(recommendationHint) ? recommendationHint : null,
+                recommendation_meta: recommendationMeta,
+                selected: selectedHint,
+                suggested: selectedHint ? [selectedHint] : [],
+                suggested_count: suggestedAgents.length,
+            },
+        },
+        packet_2: {
+            status: packet2Status,
+            required: packet2Status === 'required',
+            enrichment_id: enrichmentId,
+            fetch_tool: 'gramatr_get_packet_two',
+        },
+        required_actions: buildRequiredActions(packet2Status, enrichmentId),
+    };
+    return renderContractBlock(envelope);
 }
 export function emitStatus(data, elapsed, lastFailure) {
     if (!data) {