sneakoscope 5.7.0 → 5.9.0

package/dist/core/routes.js

@@ -408,19 +408,19 @@ export const ROUTES = [
         examples: ['$Research investigate this idea']
     },
     {
-        id: 'InsaneSearch',
-        command: '$Insane-Search',
-        mode: 'ULTRA_SEARCH',
+        id: 'SuperSearch',
+        command: '$Super-Search',
+        mode: 'SUPER_SEARCH',
         route: 'provider-independent source intelligence',
-        description: 'Run InsaneSearch source acquisition, source normalization, claim/proof ledgers, and provider-independent citation evidence without requiring xAI/Grok.',
-        requiredSkills: ['insane-search', 'pipeline-runner', 'context7-docs', 'honest-mode'],
-        dollarAliases: ['$InsaneSearch', '$Ultra-Search', '$UltraSearch'],
-        lifecycle: ['source_intent', 'query_variants', 'provider_plan', 'source_ledgers', 'claim_ledgers', 'ultra_search_gate', 'honest_mode'],
+        description: 'Run Super-Search source acquisition, source normalization, claim/proof ledgers, and provider-independent citation evidence without requiring xAI/Grok.',
+        requiredSkills: ['super-search', 'pipeline-runner', 'context7-docs', 'honest-mode'],
+        appSkillAliases: ['super-search'],
+        lifecycle: ['source_intent', 'query_variants', 'provider_plan', 'source_ledgers', 'claim_ledgers', 'super_search_gate', 'honest_mode'],
         context7Policy: 'if_external_docs',
         reasoningPolicy: 'high',
-        stopGate: 'ultra-search/ultra-search-gate.json',
-        cliEntrypoint: 'sks insane-search doctor|run|x|fetch|status|inspect|sources|claims|cache|bench|migrate-xai',
-        examples: ['$Insane-Search run "current package release notes"', '$InsaneSearch x "site:x.com product launch"']
+        stopGate: 'super-search/super-search-gate.json',
+        cliEntrypoint: 'sks super-search doctor|run|x|fetch|status|inspect|sources|claims|cache|bench',
+        examples: ['$Super-Search run "current package release notes"', '$Super-Search x "site:x.com product launch"']
     },
     {
         id: 'SEOGEOOptimizer',
@@ -599,9 +599,8 @@ export const COMMAND_CATALOG = [
     { name: 'image-ux-review', usage: 'sks ux-review run --image <path> --fix --json | sks image-ux-review status <mission-id|latest> [--json]', description: 'Run or inspect $Image-UX-Review gpt-image-2/imagegen annotated UI/UX review artifacts, issue ledgers, safe fix loops, recapture, and proof gates.' },
     { name: 'computer-use', usage: 'sks computer-use import|status|smoke|require ... [--json]', description: 'Record native Mac/non-web Computer Use visual evidence while keeping web verification on the Chrome Extension path.' },
     { name: 'context7', usage: 'sks context7 check|setup|tools|resolve|docs|evidence ...', description: 'Check, configure, and call the local Context7 MCP requirement.' },
-    { name: 'insane-search', usage: 'sks insane-search doctor|run|x|fetch|status|inspect|sources|claims|cache|bench|migrate-xai', description: 'Run provider-independent InsaneSearch source intelligence.' },
-    { name: 'ultra-search', usage: 'compatibility alias for sks insane-search', description: 'Deprecated compatibility alias; use sks insane-search.' },
-    { name: 'xai', usage: 'sks xai check|status|docs', description: 'Deprecated compatibility notice; use sks insane-search.' },
+    { name: 'super-search', usage: 'sks super-search doctor|run|x|fetch|status|inspect|sources|claims|cache|bench', description: 'Run Super-Search provider-independent source intelligence.' },
+    { name: 'xai', usage: 'sks xai check|status|docs', description: 'Deprecated compatibility notice; use sks super-search.' },
     { name: 'recallpulse', usage: 'sks recallpulse run|status|eval|governance|checklist <mission-id|latest>', description: 'Run report-only RecallPulse active recall, durable status, proof capsule, evidence envelope, and governance checks.' },
     { name: 'pipeline', usage: 'sks pipeline status|resume|plan|answer ...', description: 'Inspect the active skill-first route, materialized execution plan, ambiguity gates, and completion gates.' },
     { name: 'guard', usage: 'sks guard check [--json]', description: 'Check SKS harness self-protection lock, fingerprints, and source-repo exception state.' },
@@ -643,7 +642,7 @@ export const COMMAND_CATALOG = [
     { name: 'gx', usage: 'sks gx init|render|validate|drift|snapshot [name]', description: 'Create and verify deterministic SVG/HTML visual context cartridges.' },
     { name: 'profile', usage: 'sks profile show|set <model>', description: 'Inspect or set the current SKS model profile metadata.' },
     { name: 'gc', usage: 'sks gc [--dry-run] [--json]', description: 'Compact oversized logs and prune stale runtime artifacts.' },
-    { name: 'stats', usage: 'sks stats [--json]', description: 'Show package and .sneakoscope storage size.' },
+    { name: 'stats', usage: 'sks stats [--full] [--json]', description: 'Show package and .sneakoscope storage size.' },
     { name: 'mcp-server', usage: 'sks mcp-server [--expose-exec] [--probe]', description: 'Run a stdio MCP server exposing SKS read-only commands as tools for any MCP-capable agent host; --expose-exec also exposes non-read-only commands; --probe round-trips initialize/tools-list and exits.' },
     { name: 'agent-bridge', usage: 'sks agent-bridge setup [--json]', description: 'Publish the agent-bridge manifest, print host registration snippets (generic MCP host, Codex CLI, non-interactive contract), and run a live non-interactive smoke test.' }
 ];
@@ -785,80 +784,160 @@ export function looksLikeGenerativeEngineOptimizationRequest(prompt = '') {
     const text = String(prompt || '');
     return /\b(?:GEO|generative\s+engine\s+optimization|AI\s+(?:answer|search)\s+(?:visibility|discoverability)|LLM\s+(?:citation|answer|visibility|discoverability)|answerability|entity\s+(?:facts?|clarity)|claim\s+evidence|crawler\s+policy|OAI-SearchBot|GPTBot|ChatGPT-User|Claude-SearchBot|ClaudeBot|Claude-User|llms\.txt|AI\s*검색\s*가시성|AI\s*답변\s*가시성|생성형\s*엔진\s*최적화)\b/i.test(text);
 }
-export function looksLikeUltraSearchRequest(prompt = '') {
+export function looksLikeSuperSearchRequest(prompt = '') {
     const text = String(prompt || '');
-    return /\b(?:InsaneSearch|Insane-Search|insane\s*search|UltraSearch|Ultra-Search|ultra\s*search|source\s+intelligence|provider-independent\s+source|source\s+acquisition|citation\s+proof|x-search)\b|인세인\s*서치|울트라\s*서치|소스\s*인텔리전스/i.test(text);
+    return /\b(?:SuperSearch|Super-Search|source\s+intelligence|provider-independent\s+source|source\s+acquisition|citation\s+proof|x-search|site:x\.com|site:twitter\.com)\b|슈퍼\s*서치|소스\s*인텔리전스/i.test(text);
 }
 export function routePrompt(prompt) {
     const text = stripVisibleDecisionAnswerBlocks(prompt);
+    const intentScores = scorePromptIntent(text);
+    const select = (route) => withPromptIntentScores(route, intentScores);
     if (/^\$?plan\b/i.test(text))
-        return routeById('Planner');
+        return select(routeById('Planner'));
     if (/^\$?work\b/i.test(text))
-        return routeById('Naruto');
+        return select(routeById('Naruto'));
     if (/^\$?swarm\b/i.test(text))
-        return routeById('Naruto');
+        return select(routeById('Naruto'));
     const command = dollarCommand(text);
     if (command) {
         if (command === 'MAD-SKS') {
             const afterModifier = stripMadSksSignal(text);
             const nestedCommand = dollarCommand(afterModifier);
             if (nestedCommand)
-                return routeByDollarCommand(nestedCommand) || routeById('MadSKS');
+                return select(routeByDollarCommand(nestedCommand) || routeById('MadSKS'));
             if (looksLikeAnswerOnlyRequest(afterModifier))
-                return routeById('Answer');
+                return select(routeById('Answer'));
             if (looksLikeCodeChangingWork(afterModifier) || looksLikeDirectWorkRequest(afterModifier))
-                return routeById('Naruto');
-            return routeById('MadSKS');
+                return select(routeById('Naruto'));
+            return select(routeById('MadSKS'));
         }
         const route = routeByDollarCommand(command) || routeById('SKS');
         if (route?.id === 'SKS' && looksLikeTeamDefaultWork(stripDollarCommand(text)))
-            return routeById('Naruto');
+            return select(routeById('Naruto'));
         if (route?.id === 'Team')
-            return routeById('Naruto');
-        return route;
+            return select(routeById('Naruto'));
+        return select(route);
     }
     if (hasFromChatImgSignal(text))
-        return routeById('Naruto');
+        return select(routeById('Naruto'));
     const simpleGitRoute = simpleGitOnlyRouteId(text);
     if (simpleGitRoute)
-        return routeById(simpleGitRoute);
+        return select(routeById(simpleGitRoute));
     if (looksLikePresentationArtifactRequest(text))
-        return routeById('PPT');
+        return select(routeById('PPT'));
     if (looksLikeImageUxReviewRequest(text))
-        return routeById('ImageUXReview');
+        return select(routeById('ImageUXReview'));
     if (looksLikeComputerUseFastLane(text))
-        return routeById('ComputerUse');
+        return select(routeById('ComputerUse'));
     if (looksLikeTinyDirectFix(text))
-        return routeById('DFix');
+        return select(routeById('DFix'));
+    if (/\b(SQL|Supabase|Postgres|migration|RLS|Prisma|Drizzle|Knex|database|DB|execute_sql)\b/i.test(text))
+        return select(routeById('DB'));
+    if (looksLikeSuperSearchRequest(text) && !looksLikeCodeChangingWork(text))
+        return select(routeById('SuperSearch'));
     if (looksLikeQuestionShapedDirective(text))
-        return routeById('Naruto');
+        return select(routeById('Naruto'));
+    if (looksLikeDirectWorkRequest(text))
+        return select(routeById('Naruto'));
     if (looksLikeAnswerOnlyRequest(text))
-        return routeById('Answer');
-    if (/\b(SQL|Supabase|Postgres|migration|RLS|Prisma|Drizzle|Knex|database|DB|execute_sql)\b/i.test(text))
-        return routeById('DB');
+        return select(routeById('Answer'));
     if (/\b(team|multi-agent|subagent|parallel agents|agent team)\b|병렬|팀/i.test(text))
-        return routeById('Naruto');
+        return select(routeById('Naruto'));
     if (looksLikeChatCaptureRequest(text) && !looksLikeAnswerOnlyRequest(text))
-        return routeById('Naruto');
+        return select(routeById('Naruto'));
     if (/\b(qa[-\s]?loop|qaloop|e2e\s+qa|qa\s+e2e)\b/i.test(text))
-        return routeById('QALoop');
-    if (looksLikeUltraSearchRequest(text) && !looksLikeCodeChangingWork(text) && !looksLikeAnswerOnlyRequest(text))
-        return routeById('InsaneSearch');
+        return select(routeById('QALoop'));
+    if (looksLikeSuperSearchRequest(text) && !looksLikeCodeChangingWork(text) && !looksLikeAnswerOnlyRequest(text))
+        return select(routeById('SuperSearch'));
     if (looksLikeGenerativeEngineOptimizationRequest(text))
-        return routeById('SEOGEOOptimizer');
+        return select(routeById('SEOGEOOptimizer'));
     if (looksLikeSeoRequest(text))
-        return routeById('SEOGEOOptimizer');
+        return select(routeById('SEOGEOOptimizer'));
     if (/\b(autoresearch|experiment|benchmark|ranking|optimi[sz]e|improve metric|github stars?|npm downloads?|스타|다운로드)\b/i.test(text))
-        return routeById('AutoResearch');
+        return select(routeById('AutoResearch'));
     if (/\b(research|hypothesis|falsify|novelty|frontier|조사|연구)\b/i.test(text))
-        return routeById('Research');
+        return select(routeById('Research'));
     if (/(wiki\s+(refresh|pack|validate|prune)|triwiki\s+(refresh|pack|validate)|위키\s*(갱신|리프레시|정리|검증|패킹)|트라이위키|triwiki)/i.test(text) && !looksLikeDirectWorkRequest(text))
-        return routeById('Wiki');
+        return select(routeById('Wiki'));
     if (/\b(GX|vgraph|visual context|render cartridge|wiki coordinate|rgba|trig|llm wiki)\b/i.test(text))
-        return routeById('GX');
+        return select(routeById('GX'));
     if (looksLikeTeamDefaultWork(text))
-        return routeById('Naruto');
-    return routeById('SKS');
+        return select(routeById('Naruto'));
+    return select(routeById('SKS'));
+}
+export function scorePromptIntent(prompt = '') {
+    const text = String(prompt || '').trim();
+    const reasons = new Set();
+    const questionShape = /(?:\?|^(?:why|what|how|when|where|who|which|can|could|should|would)\b|^(?:왜|뭐|무엇|어떻게|언제|어디|누구|가능|인가|인지)\b)/i.test(text);
+    const conditionalWork = looksLikeConditionalWorkRequest(text);
+    const complaintDirective = looksLikeComplaintDirectiveRequest(text);
+    const commandSignal = Boolean(dollarCommand(text));
+    const tinyDirectFix = looksLikeTinyDirectFix(text);
+    const directWork = looksLikeDirectWorkRequest(text);
+    const answerOnly = looksLikeAnswerOnlyRequest(text);
+    let answerOnlyScore = 0;
+    let directWorkScore = 0;
+    let tinyDirectFixScore = 0;
+    let researchScore = 0;
+    let dbScore = 0;
+    let superSearchScore = 0;
+    if (questionShape) {
+        answerOnlyScore += 1;
+        reasons.add('question_shape');
+    }
+    if (commandSignal)
+        reasons.add('command_signal');
+    if (tinyDirectFix) {
+        tinyDirectFixScore += 5;
+        directWorkScore += 2;
+        reasons.add('tiny_direct_fix');
+    }
+    if (conditionalWork) {
+        directWorkScore += 5;
+        reasons.add('conditional_work');
+    }
+    if (complaintDirective) {
+        directWorkScore += 4;
+        reasons.add('complaint_directive');
+    }
+    if (looksLikeQuestionShapedDirective(text)) {
+        directWorkScore += 4;
+        reasons.add('question_shaped_directive');
+    }
+    if (directWork) {
+        directWorkScore += 3;
+        reasons.add('direct_work');
+    }
+    if (answerOnly) {
+        answerOnlyScore += 4;
+        reasons.add('answer_only');
+    }
+    if (/\b(research|hypothesis|falsify|novelty|frontier|조사|연구)\b/i.test(text)) {
+        researchScore += 2;
+        reasons.add('research');
+    }
+    if (/\b(SQL|Supabase|Postgres|migration|RLS|Prisma|Drizzle|Knex|database|DB|execute_sql)\b/i.test(text)) {
+        dbScore += 3;
+        reasons.add('db');
+    }
+    if (looksLikeSuperSearchRequest(text)) {
+        superSearchScore += 4;
+        reasons.add('super_search');
+    }
+    return {
+        answerOnly: answerOnlyScore,
+        directWork: directWorkScore,
+        tinyDirectFix: tinyDirectFixScore,
+        research: researchScore,
+        db: dbScore,
+        superSearch: superSearchScore,
+        reasons: [...reasons]
+    };
+}
+function withPromptIntentScores(route, intentScores) {
+    if (!route)
+        return route;
+    return { ...route, intent_scores: intentScores };
 }
 export function looksLikeComputerUseFastLane(prompt = '') {
     const text = String(prompt || '');
@@ -883,6 +962,10 @@ export function looksLikeAnswerOnlyRequest(prompt = '') {
         return false;
     if (looksLikeQuestionShapedDirective(text))
         return false;
+    if (looksLikeConditionalWorkRequest(text))
+        return false;
+    if (looksLikeComplaintDirectiveRequest(text))
+        return false;
     const infoCue = /(왜|뭐야|무엇|뭔가|어떤|어떻게|언제|어디|누구|얼마|가능해|맞아|인가|인지|차이|의미|원리|이유|방법|설명|알려줘|요약|정리|비교|찾아줘|찾아봐|검색|조사|근거|출처|fact|source|cite|explain|what|why|how|when|where|who|which|whether|compare|summari[sz]e|search|look up|research|tell me|question|\?)/i.test(text);
     if (!infoCue)
         return false;
@@ -892,15 +975,18 @@ export function looksLikeQuestionShapedDirective(prompt = '') {
     const text = String(prompt || '').trim();
     if (!text)
         return false;
-    const complaint = /(왜|근데|그런데).*(안\s*하|안\s*되|없이|누락|빠뜨|생략|스킵|못\s*하).*(많|자주|계속|이렇게|함|하지|하냐|하니|\?)/i.test(text);
+    const complaint = looksLikeComplaintDirectiveRequest(text);
     if (looksLikeMethodQuestion(text) && !looksLikePoliteDirectWorkRequest(text) && !looksLikeExplicitDirectWorkDirective(text) && !complaint)
         return false;
+    const questionDirective = /(?:\?|왜|why)[\s\S]{0,160}(?:질문|물음표|answer|라우팅|route|routing)[\s\S]{0,160}(?:고쳐|수정|변경|막아|fix|patch|change|update)/i.test(text);
     const directive = /(반드시|필수|무조건|해야\s*(?:해|함|돼|한다|하지|한다는|되는)|해야지|해야돼|해야한다|알지|기억해|파악해야|구분해야|막아야|보장해야|강제|기본적으로)/i.test(text);
     const pipelineCue = /(질문|질문형|암묵|지시|파이프라인|라우팅|route|routing|team|팀|sks|기본|구성|게이트|gate|작업|수정|구현|실행)/i.test(text);
-    return (directive && pipelineCue) || complaint;
+    return questionDirective || (directive && pipelineCue) || complaint;
 }
 export function looksLikeDirectWorkRequest(prompt = '') {
     const text = String(prompt || '');
+    if (/(?:설명만|설명\s*만|just\s+explain|explain\s+only|only\s+explain)/i.test(text))
+        return false;
     const explicitDirective = looksLikeExplicitDirectWorkDirective(text);
     if (looksLikeDirectFixQuestion(text) && !explicitDirective)
         return false;
@@ -908,11 +994,27 @@ export function looksLikeDirectWorkRequest(prompt = '') {
         return false;
     return looksLikeCodeChangingWork(text)
         || looksLikeChatCaptureRequest(text)
+        || looksLikeConditionalWorkRequest(text)
         || looksLikeQuestionShapedDirective(text)
         || explicitDirective
         || /(작업|파이프라인|구현|수정|변경|추가|적용|반영|처리|수행|검수|설치|해결|리드미|README).*(해줘|해달|해라|해야|되게|줘야|줘야지|달라)/i.test(text)
         || /(진행해|수행해|작업해|처리해|적용해|반영해|검수해|고쳐줘|바꿔줘|해결해줘|만들어줘|해줘야|해줘야지|해달라|해야지|되게 해|install|run|execute|test|deploy|commit|push)/i.test(text);
 }
+function looksLikeConditionalWorkRequest(prompt = '') {
+    const text = String(prompt || '').trim();
+    if (!text)
+        return false;
+    return /(확인하고|검토하고|봐서|보고|문제\s*있으면|가능한지).*(고쳐|수정|변경|처리|해결|진행|반영|해줘|해달)/i.test(text)
+        || /\b(?:check|inspect|verify|see)\b[\s\S]{0,120}\b(?:if|whether|when)\b[\s\S]{0,120}\b(?:fix|patch|update|change|repair|resolve)\b/i.test(text)
+        || /\b(?:if|when)\b[\s\S]{0,120}\b(?:problem|issue|bug|broken|fails?)\b[\s\S]{0,120}\b(?:fix|patch|update|change|repair|resolve)\b/i.test(text);
+}
+function looksLikeComplaintDirectiveRequest(prompt = '') {
+    const text = String(prompt || '').trim();
+    if (!text)
+        return false;
+    return /(왜|근데|그런데).*(안\s*하|안\s*되|없이|누락|빠뜨|생략|스킵|못\s*하).*(많|자주|계속|이렇게|함|하지|하냐|하니|\?)/i.test(text)
+        || /\bwhy\b[\s\S]{0,80}\b(?:not|missing|skipped|failed|still|keeps?)\b[\s\S]{0,120}\b(?:fix|patch|route|routing|work|do|done)\b/i.test(text);
+}
 function looksLikeExplicitDirectWorkDirective(prompt = '') {
     const text = String(prompt || '').trim();
     if (!text)
@@ -945,7 +1047,7 @@ export function routeRequiresSubagents(route, prompt = '') {
         return false;
     if (route.id === 'ImageUXReview')
         return false;
-    if (route.id === 'InsaneSearch')
+    if (route.id === 'SuperSearch')
         return false;
     if (route.id === 'SEOGEOOptimizer')
         return false;
@@ -1030,7 +1132,7 @@ export function routeReasoning(route, prompt = '') {
         return narutoRouteReasoning(text);
     if (route?.id === 'Research' || route?.id === 'AutoResearch')
         return reasoning('xhigh', 'research_or_experiment_route');
-    if (route?.id === 'InsaneSearch')
+    if (route?.id === 'SuperSearch')
         return reasoning('high', 'source_intelligence_route');
     if (route?.id === 'SEOGEOOptimizer')
         return reasoning('high', 'search_visibility_route');

package/dist/core/source-intelligence/source-intelligence-policy.js

@@ -23,7 +23,7 @@ export function buildSourceIntelligencePolicy(input = {}) {
         wrongnessKinds.push('context7_missing');
     }
     if (!offline && codex.status === 'unavailable') {
-        warnings.push('codex_web_search_unavailable_degraded_to_ultra_cache_or_docs');
+        warnings.push('codex_web_search_unavailable_degraded_to_super_cache_or_docs');
         wrongnessKinds.push('codex_web_search_missing');
     }
     if (input.xaiDetection)
@@ -37,8 +37,8 @@ export function buildSourceIntelligencePolicy(input = {}) {
                 : xIntent
                     ? 'x_search'
                     : /deep|exhaustive|가능한 전부|누락 없이|완벽하게 조사/i.test(query)
-                        ? 'ultra_deep'
-                        : 'ultra_balanced');
+                        ? 'super_deep'
+                        : 'super_balanced');
     const selected = new Set();
     if (docsIntent && context7Available)
         selected.add('context7');
@@ -56,8 +56,8 @@ export function buildSourceIntelligencePolicy(input = {}) {
         mode,
         requirements: {
             official_sources: docsIntent,
-            full_content: mode !== 'ultra_fast',
-            counter_search: mode === 'ultra_deep' || mode === 'ultra_exhaustive',
+            full_content: mode !== 'super_fast',
+            counter_search: mode === 'super_deep' || mode === 'super_exhaustive',
             claim_ledger: true,
             social_recency: xIntent || mode === 'x_search',
             code_execution_verification: /\b(code|implementation|test|runtime|구현)\b/i.test(query)

package/dist/core/source-intelligence/source-intelligence-proof.js

@@ -3,19 +3,19 @@ export function buildSourceIntelligenceProof(policy, evidence) {
     const blockers = [...policy.blockers];
     const wrongnessKinds = [...policy.wrongness_kinds];
     const context7Ok = policy.context7.required ? evidence.context7?.ok === true : true;
-    const ultraOk = evidence.ultra_search?.proof.provider_independent === true && evidence.ultra_search?.proof.xai_runtime_dependency === false;
+    const superSearchOk = evidence.super_search?.proof.provider_independent === true && evidence.super_search?.proof.xai_runtime_dependency === false;
     const appshotsRequired = evidence.appshots?.capability.visual_required === true;
     const appshotsOk = appshotsRequired ? evidence.appshots?.ok === true : true;
     if (policy.context7.required && !context7Ok) {
         blockers.push('context7_missing');
         wrongnessKinds.push('context7_missing');
     }
-    if (!ultraOk) {
-        blockers.push('ultra_search_provider_independent_proof_missing');
-        wrongnessKinds.push('ultra_search_provider_independent_proof_missing');
+    if (!superSearchOk) {
+        blockers.push('super_search_provider_independent_proof_missing');
+        wrongnessKinds.push('super_search_provider_independent_proof_missing');
     }
-    if (evidence.ultra_search?.proof.blockers.length)
-        blockers.push(...evidence.ultra_search.proof.blockers);
+    if (evidence.super_search?.proof.blockers.length)
+        blockers.push(...evidence.super_search.proof.blockers);
     if (appshotsRequired && !appshotsOk) {
         blockers.push('appshots_operator_action_missing');
         wrongnessKinds.push('appshots_operator_action_missing');
@@ -28,8 +28,8 @@ export function buildSourceIntelligenceProof(policy, evidence) {
             context7_required: policy.context7.required,
             context7_ok: context7Ok,
             codex_web_required: policy.codex_web_search.required,
-            ultra_search_ok: ultraOk,
-            provider_independent: evidence.ultra_search?.proof.provider_independent === true,
+            super_search_ok: superSearchOk,
+            provider_independent: evidence.super_search?.proof.provider_independent === true,
             appshots_required: appshotsRequired,
             appshots_ok: appshotsOk
         },

package/dist/core/source-intelligence/source-intelligence-runner.js

@@ -1,7 +1,7 @@
 import path from 'node:path';
 import { ensureDir, nowIso, sha256, writeJsonAtomic, writeTextAtomic } from '../fsx.js';
 import { detectCodexWebSearchCapability } from '../codex/codex-web-search-adapter.js';
-import { runUltraSearch } from '../ultra-search/index.js';
+import { runSuperSearch } from '../super-search/index.js';
 import { buildSourceIntelligencePolicy, writeSourceIntelligencePolicyArtifact } from './source-intelligence-policy.js';
 import { buildSourceIntelligenceProof } from './source-intelligence-proof.js';
 import { buildAppshotsEvidence, writeAppshotsEvidenceArtifact } from './appshots-evidence.js';
@@ -29,13 +29,13 @@ export async function runSourceIntelligence(input) {
         offline: input.offline === true,
         ...(input.context7 ? { context7: input.context7 } : {})
     });
-    const ultraMode = sourceModeToUltraMode(policy.mode);
-    const ultraSearch = await runUltraSearch({
+    const superSearchMode = sourceModeToSuperSearchMode(policy.mode);
+    const superSearch = await runSuperSearch({
         root,
         missionDir,
         route: input.route || 'unknown',
         query: input.query,
-        mode: ultraMode,
+        mode: superSearchMode,
         ...(input.offline === undefined ? {} : { offline: input.offline }),
         ...(input.context7 ? { context7: input.context7 } : {}),
         ...(input.codexWebSearch ? { codexWebSearch: input.codexWebSearch } : {}),
@@ -54,13 +54,13 @@ export async function runSourceIntelligence(input) {
     const providersRequested = policy.selected_providers;
     const providersCompleted = [
         ...(context7.ok && policy.context7.required ? ['context7'] : []),
-        ...(ultraSearch.sources.some((source) => source.provider_id === 'codex_web') ? ['codex_web'] : []),
-        ...(ultraSearch.sources.some((source) => source.provider_id === 'x_public') ? ['x_public'] : []),
-        'ultra_search'
+        ...(superSearch.sources.some((source) => source.provider_id === 'codex_web') ? ['codex_web'] : []),
+        ...(superSearch.sources.some((source) => source.provider_id === 'x_public') ? ['x_public'] : []),
+        'super_search'
     ];
-    const proof = buildSourceIntelligenceProof(policy, { context7, ultra_search: ultraSearch, appshots });
+    const proof = buildSourceIntelligenceProof(policy, { context7, super_search: superSearch, appshots });
     const blockers = [...new Set([...policy.blockers, ...context7.blockers, ...appshots.blockers, ...proof.blockers])];
-    const warnings = [...new Set([...policy.warnings, ...ultraSearch.warnings, ...appshots.warnings])];
+    const warnings = [...new Set([...policy.warnings, ...superSearch.warnings, ...appshots.warnings])];
     const cacheKey = sha256(JSON.stringify({ route: input.route || 'unknown', query: input.query, mode: policy.mode })).slice(0, 16);
     const evidence = {
         schema: SOURCE_INTELLIGENCE_EVIDENCE_SCHEMA,
@@ -77,12 +77,12 @@ export async function runSourceIntelligence(input) {
         cache: {
             key: cacheKey,
             local_only: true,
-            ultra_search_hit: ultraSearch.cache.hit
+            super_search_hit: superSearch.cache.hit
         },
         policy,
         context7,
         codex_web_search: null,
-        ultra_search: ultraSearch,
+        super_search: superSearch,
         appshots,
         proof,
         blockers,
@@ -102,7 +102,7 @@ export function renderSourceIntelligenceEvidenceMarkdown(evidence) {
         `- Route: ${evidence.route}`,
         `- Mode: ${evidence.mode}`,
         `- Context7: ${evidence.context7.status}`,
-        `- UltraSearch: ${evidence.ultra_search.proof.ok ? 'ok' : 'partial'}`,
+        `- Super-Search: ${evidence.super_search.proof.ok ? 'ok' : 'partial'}`,
         `- Legacy x-search MCP: not_required`,
         `- Appshots: ${evidence.appshots?.status || 'not_required'}`,
         `- Providers completed: ${evidence.parallel.providers_completed.join(', ') || 'none'}`,
@@ -110,12 +110,12 @@ export function renderSourceIntelligenceEvidenceMarkdown(evidence) {
         ''
     ].join('\n');
 }
-function sourceModeToUltraMode(mode) {
-    if (mode === 'ultra_fast')
+function sourceModeToSuperSearchMode(mode) {
+    if (mode === 'super_fast')
         return 'fast';
-    if (mode === 'ultra_deep')
+    if (mode === 'super_deep')
         return 'deep';
-    if (mode === 'ultra_exhaustive')
+    if (mode === 'super_exhaustive')
         return 'exhaustive';
     if (mode === 'url_acquisition')
         return 'url_acquisition';

package/dist/core/strategy/strategy-gate.js

@@ -3,6 +3,7 @@ import { nowIso, writeJsonAtomic } from '../fsx.js';
 export const STRATEGY_GATE_SCHEMA = 'sks.strategy-gate.v1';
 export function evaluateStrategyGate(input) {
     const writeCapable = input.writeCapable === true;
+    const sourceIntelligenceRequired = input.sourceIntelligenceRequired !== false;
     const gate = input.compiled.gate;
     const strategyFirstRequired = writeCapable || gate.visual_appshot_required_count > 0 || input.visualRequired === true;
     const blockers = [
@@ -13,7 +14,7 @@ export function evaluateStrategyGate(input) {
         ...(writeCapable && input.visualRequired === true && input.appshotsOk !== true
             ? ['appshots_operator_action_missing_for_visual_proof']
             : []),
-        ...(writeCapable && input.sourceIntelligenceOk === false ? ['source_intelligence_gate_failed'] : [])
+        ...(writeCapable && sourceIntelligenceRequired && input.sourceIntelligenceOk === false ? ['source_intelligence_gate_failed'] : [])
     ];
     return {
         schema: STRATEGY_GATE_SCHEMA,

package/dist/core/super-search/doctor.js

@@ -0,0 +1,63 @@
+import { humanizeBlockers } from '../errors/blocker-humanizer.js';
+export function buildSuperSearchDoctorReport(args = [], env = process.env) {
+    const offline = args.includes('--offline');
+    const codexWebAvailable = env.SKS_CODEX_WEB_SEARCH_AVAILABLE === '1' || env.CODEX_WEB_SEARCH_AVAILABLE === '1';
+    const directUrlFetchAvailable = typeof globalThis.fetch === 'function';
+    const minimumAcquisitionPathReady = directUrlFetchAvailable || codexWebAvailable;
+    const status = offline
+        ? 'offline_usable'
+        : minimumAcquisitionPathReady
+            ? 'usable'
+            : 'degraded';
+    const blockers = status === 'degraded' ? ['source_acquisition_unavailable'] : [];
+    const diagnostics = humanizeBlockers(blockers, []);
+    return {
+        schema: 'sks.super-search-doctor.v2',
+        ok: status === 'usable' || status === 'offline_usable',
+        status,
+        core_ready: true,
+        minimum_acquisition_path_ready: minimumAcquisitionPathReady,
+        xai_required: false,
+        providers: {
+            direct_url_fetch: {
+                status: directUrlFetchAvailable ? 'available' : 'not_available',
+                real_smoke_passed: directUrlFetchAvailable
+            },
+            codex_web: {
+                status: codexWebAvailable ? 'available' : 'not_bound'
+            },
+            context7: {
+                status: 'not_bound'
+            },
+            x_public: {
+                status: 'discovery_only'
+            },
+            offline_cache: {
+                status: offline ? 'available' : 'explicit_offline_only'
+            }
+        },
+        optional: {
+            context7: 'external_runtime_optional_by_intent',
+            codex_web: codexWebAvailable ? 'available' : 'not_bound',
+            authenticated_chrome: 'operator_consented_optional',
+            official_x_api: 'credentials_optional_not_required'
+        },
+        blockers,
+        human_summary: diagnostics.human_summary,
+        next_actions: diagnostics.next_actions,
+        evidence_paths: diagnostics.evidence_paths,
+        warnings: []
+    };
+}
+export function printSuperSearchDoctorReport(report, json) {
+    if (json) {
+        console.log(JSON.stringify(report, null, 2));
+        return;
+    }
+    console.log(`Super-Search doctor: ${report.status}; xAI/Grok is not required.`);
+    if (report.blockers.length) {
+        console.log(`Blockers: ${report.blockers.join(', ')}`);
+        console.log(`Next actions: ${report.next_actions.join('; ')}`);
+    }
+}
+//# sourceMappingURL=doctor.js.map