sneakoscope 0.7.78 → 0.8.2

package/src/core/research.mjs

@@ -1,6 +1,7 @@
 import path from 'node:path';
 import { appendJsonlBounded, nowIso, readJson, readText, writeJsonAtomic, writeTextAtomic, exists } from './fsx.mjs';
 import { OUTCOME_RUBRIC } from './proof-field.mjs';
+import { RESEARCH_SCOUT_PERSONA_CONTRACT, validateResearchScoutPersonas } from './recallpulse.mjs';
 
 export const RESEARCH_PAPER_ARTIFACT = 'research-paper.md';
 export const RESEARCH_SOURCE_SKILL_ARTIFACT = 'research-source-skill.md';
@@ -16,43 +17,11 @@ export const RESEARCH_PAPER_SECTION_GROUPS = Object.freeze([
   ['references', 'sources']
 ]);
 
-export const RESEARCH_SCOUT_COUNCIL = Object.freeze([
-  {
-    id: 'einstein',
-    label: 'Einstein lens',
-    role: 'first_principles_reframer',
-    mandate: 'Reframe the problem around invariants, constraints, symmetry, and thought experiments.',
-    required_outputs: ['eureka_moment', 'assumptions_to_remove', 'invariant_or_simplifying_frame', 'decisive_thought_experiment']
-  },
-  {
-    id: 'feynman',
-    label: 'Feynman lens',
-    role: 'explanation_experimentalist',
-    mandate: 'Reduce the idea to a teachable mechanism, toy example, and cheap empirical probe.',
-    required_outputs: ['eureka_moment', 'plain_language_mechanism', 'toy_model', 'cheap_probe']
-  },
-  {
-    id: 'turing',
-    label: 'Turing lens',
-    role: 'formalization_and_adversarial_cases',
-    mandate: 'Formalize inputs, outputs, algorithms, computability limits, and adversarial countercases.',
-    required_outputs: ['eureka_moment', 'formal_definition', 'algorithmic_shape', 'edge_or_adversarial_case']
-  },
-  {
-    id: 'von_neumann',
-    label: 'von Neumann lens',
-    role: 'systems_strategy_scout',
-    mandate: 'Map system dynamics, strategic incentives, scaling behavior, and worst-case interactions.',
-    required_outputs: ['eureka_moment', 'system_model', 'strategic_or_scaling_risk', 'robustness_condition']
-  },
-  {
-    id: 'skeptic',
-    label: 'Skeptic lens',
-    role: 'counterevidence_scout',
-    mandate: 'Find disconfirming sources, replication risks, base-rate failures, and claims that should be weakened.',
-    required_outputs: ['eureka_moment', 'counterevidence', 'base_rate_or_failure_mode', 'claim_to_downgrade']
-  }
-]);
+export const RESEARCH_SCOUT_COUNCIL = Object.freeze(RESEARCH_SCOUT_PERSONA_CONTRACT.map((scout) => Object.freeze({
+  ...scout,
+  label: scout.display_name,
+  required_outputs: scout.required_outputs
+})));
 
 export const RESEARCH_SOURCE_LAYERS = Object.freeze([
   {
@@ -125,8 +94,10 @@ export function createResearchPlan(prompt, opts = {}) {
     methodology: 'genius-scout-council-frontier-discovery-loop',
     objective: 'Find the shortest useful mechanism that can be falsified or applied, grounded in maximum available source retrieval rather than broad summary.',
     execution_policy: {
-      normal_run: 'real_long_running_research',
+      normal_run: 'real_long_running_research_until_unanimous_scout_consensus',
       default_cycle_timeout_minutes: 120,
+      default_max_cycles: 12,
+      safety_cap: 'Research repeats scout/debate/falsification cycles until unanimous scout consensus or an explicit max-cycle safety cap pauses the run.',
       mock_policy: '--mock is for selftests and dry harness checks only; normal Research must block rather than silently substitute mock output.'
     },
     outcome_rubric: OUTCOME_RUBRIC,
@@ -143,8 +114,8 @@ export function createResearchPlan(prompt, opts = {}) {
         rule: 'Every scout must record one literal Eureka! moment with a non-obvious idea before debate.'
       },
       debate_policy: {
-        mode: 'vigorous_evidence_bound_debate',
-        rule: 'Every scout must challenge at least one other scout or respond to a challenge before synthesis.'
+        mode: 'vigorous_evidence_bound_debate_until_unanimous_consensus',
+        rule: 'Every scout must challenge at least one other scout or respond to a challenge before synthesis. The loop repeats until every scout records final agreement on the surviving mechanism or the safety cap pauses the run with an unpassed gate.'
       },
       scouts: RESEARCH_SCOUT_COUNCIL,
       protocol: [
@@ -189,12 +160,18 @@ export function createResearchPlan(prompt, opts = {}) {
         triangulation_checks: 1
       }
     },
+    mutation_policy: {
+      implementation_allowed: false,
+      allowed_write_scope: 'route-local mission artifacts only',
+      rule: 'Normal Research must not modify repository source, package, docs, config, or generated harness files. It may write only artifacts under its own .sneakoscope/missions/<mission-id>/ directory.'
+    },
     rules: [
+      'Do not modify code or project source files during Research. Research writes only route-local mission artifacts; implementation belongs to $Team or another execution route.',
       'Do not claim novelty without a novelty ledger entry.',
       'Separate facts, inferences, hypotheses, and speculations.',
       'Run the genius-lens scout council independently before synthesis.',
       'Every Research scout must run at reasoning_effort=xhigh, record one literal "Eureka!" idea, and participate in the debate.',
-      'The scout council must debate vigorously but stay evidence-bound; record challenges and responses in debate-ledger.json.',
+      'The scout council must debate vigorously but stay evidence-bound; record challenges and responses in debate-ledger.json. Continue cycles until unanimous_consensus=true with every scout agreeing.',
       'Maximize safe web/source search as layered source retrieval and record queries, source layers, citations, quality notes, triangulation checks, and blockers in source-ledger.json.',
       `Create ${RESEARCH_SOURCE_SKILL_ARTIFACT} as a route-local source collection skill before synthesis; do not edit generated .agents/skills during the research run.`,
       'Actively seek disconfirming evidence before synthesis.',
@@ -209,7 +186,7 @@ export function createResearchPlan(prompt, opts = {}) {
       { id: 'R1_SOURCE_SKILL', goal: `Create ${RESEARCH_SOURCE_SKILL_ARTIFACT} with layer-specific search routes, quality fields, and blockers before source gathering.` },
       { id: 'R2_SOURCE_SEARCH', goal: 'Run layered web/source retrieval across papers, official data, standards, news, public discourse, developer knowledge, and counterevidence.' },
       { id: 'R3_EUREKA', goal: 'Have each xhigh genius-lens scout shout Eureka! and record one non-obvious idea with source ids.' },
-      { id: 'R4_DEBATE', goal: 'Run a vigorous evidence-bound council debate with every scout challenging or responding.' },
+      { id: 'R4_DEBATE', goal: 'Run a vigorous evidence-bound council debate with every scout challenging or responding; repeat until unanimous scout consensus is recorded.' },
       { id: 'R5_FALSIFY', goal: 'Attack each mechanism with counterexamples, missing evidence, source conflicts, and failure modes.' },
       { id: 'R6_APPLY', goal: 'Keep the smallest surviving mechanism, define a cheap probe, and write all ledgers.' },
       { id: 'R7_PAPER', goal: 'Convert the final research result into a concise paper manuscript with abstract, method, findings, limitations, and references.' },
@@ -239,8 +216,10 @@ export function researchPlanMarkdown(plan) {
   lines.push(`Methodology: ${plan.methodology}`);
   if (plan.execution_policy) {
     lines.push(`Execution: ${plan.execution_policy.normal_run}; default cycle timeout ${plan.execution_policy.default_cycle_timeout_minutes} minutes`);
+    if (plan.execution_policy.default_max_cycles) lines.push(`Consensus loop: repeat until unanimous scout consensus; default safety cap ${plan.execution_policy.default_max_cycles} cycles`);
     lines.push(`Mock policy: ${plan.execution_policy.mock_policy}`);
   }
+  if (plan.mutation_policy) lines.push(`Mutation policy: ${plan.mutation_policy.rule}`);
   lines.push('');
   lines.push('## Rules');
   for (const rule of plan.rules) lines.push(`- ${rule}`);
@@ -248,7 +227,7 @@ export function researchPlanMarkdown(plan) {
   if (plan.research_council?.scouts?.length) {
     lines.push('## Genius Scout Council');
     lines.push(`Policy: ${plan.research_council.policy}`);
-    for (const scout of plan.research_council.scouts) lines.push(`- ${scout.id}: ${scout.role} - ${scout.mandate}`);
+    for (const scout of plan.research_council.scouts) lines.push(`- ${scout.display_name || scout.label || scout.id}: ${scout.persona || scout.role} - ${scout.mandate} (${scout.persona_boundary || 'persona-inspired lens only'})`);
     lines.push('');
   }
   if (plan.web_research_policy) {
@@ -297,10 +276,12 @@ export function researchSourceSkillMarkdown(plan) {
   lines.push('- Each source entry should record title, locator/URL, publisher or author when known, published_at when known, accessed_at, layer, reliability, credibility, stance, supports or undermines, and notes.');
   lines.push('- Public discourse sources such as X/Twitter or Reddit are signals and edge cases, not truth. They must be triangulated with formal, official, practitioner, or counterevidence layers.');
   lines.push('- If a layer cannot be searched with the available runtime or credentials, record the blocker and keep research-gate.json unpassed.');
+  lines.push('- Do not modify repository source code or generated harness files during Research; write only route-local mission artifacts.');
   lines.push('');
   lines.push('## Debate Use');
   lines.push('- Every scout must cite source-ledger ids in findings and Eureka ideas.');
   lines.push('- The skeptic lens must challenge the strongest claim using counterevidence or source-quality downgrades.');
+  lines.push('- Continue scout/debate/falsification cycles until every scout agrees to the surviving mechanism. Record `unanimous_consensus=true`, `consensus_iterations`, and per-scout agreement in debate-ledger.json.');
   lines.push('- Synthesis keeps only claims that survive cross-layer triangulation and falsification.');
   lines.push('');
   return `${lines.join('\n')}\n`;
@@ -315,7 +296,8 @@ export function countGeniusOpinionSummaries(text = '') {
   const lower = String(text || '').toLowerCase();
   return RESEARCH_SCOUT_COUNCIL.filter((scout) => {
     const label = String(scout.label || '').toLowerCase();
-    return lower.includes(String(scout.id || '').toLowerCase()) || (label && lower.includes(label));
+    const display = String(scout.display_name || '').toLowerCase();
+    return lower.includes(String(scout.id || '').toLowerCase()) || (label && lower.includes(label)) || (display && lower.includes(display));
   }).length;
 }
 
@@ -399,9 +381,15 @@ export function defaultScoutLedger(plan = null) {
     created_at: nowIso(),
     scouts: scouts.map((scout) => ({
       id: scout.id,
+      display_name: scout.display_name || scout.label || scout.id,
+      historical_inspiration: scout.historical_inspiration || null,
+      persona: scout.persona || scout.role,
+      persona_boundary: scout.persona_boundary || 'persona-inspired cognitive lens only; do not impersonate the historical person',
       role: scout.role,
       mandate: scout.mandate,
       effort: 'xhigh',
+      reasoning_effort: 'xhigh',
+      service_tier: scout.service_tier || 'fast',
       eureka: {
         exclamation: 'Eureka!',
         idea: '',
@@ -411,7 +399,8 @@ export function defaultScoutLedger(plan = null) {
       query_set: [],
       findings: [],
       falsifiers: [],
-      cheap_probes: []
+      cheap_probes: [],
+      challenge_or_response: ''
     })),
     synthesis: {
       surviving_claims: [],
@@ -426,8 +415,16 @@ export function defaultDebateLedger(plan = null) {
   return {
     schema_version: 1,
     created_at: nowIso(),
-    mode: 'vigorous_evidence_bound_debate',
+    mode: 'vigorous_evidence_bound_debate_until_unanimous_consensus',
     required_participants: scouts.map((scout) => scout.id),
+    consensus_iterations: 0,
+    unanimous_consensus: false,
+    scout_agreements: scouts.map((scout) => ({
+      scout_id: scout.id,
+      agrees: false,
+      final_position: '',
+      source_ids: []
+    })),
     exchanges: [],
     synthesis_pressure: {
       strongest_disagreement: '',
@@ -474,6 +471,37 @@ function sourceLayerCoverageStats(sourceLedger = null, requiredLayerIds = RESEAR
   return { covered: [...covered], missing, required: [...requiredLayerIds] };
 }
 
+function consensusStats(debateLedger = null, gate = {}) {
+  const required = RESEARCH_SCOUT_COUNCIL.map((scout) => scout.id);
+  const rows = [
+    ...(Array.isArray(debateLedger?.scout_agreements) ? debateLedger.scout_agreements : []),
+    ...(Array.isArray(debateLedger?.consensus?.scout_agreements) ? debateLedger.consensus.scout_agreements : []),
+    ...(Array.isArray(debateLedger?.final_positions) ? debateLedger.final_positions : [])
+  ];
+  const agreed = new Set();
+  for (const row of rows) {
+    const id = row?.scout_id || row?.id || row?.scout;
+    if (required.includes(id) && (row.agrees === true || row.agreement === true || row.final_agreement === true)) agreed.add(id);
+  }
+  const explicitUnanimous = debateLedger?.unanimous_consensus === true
+    || debateLedger?.consensus?.unanimous_consensus === true
+    || debateLedger?.consensus?.unanimous === true
+    || gate.unanimous_consensus === true;
+  const iterations = Math.max(
+    Number(gate.consensus_iterations || 0),
+    Number(debateLedger?.consensus_iterations || 0),
+    Number(debateLedger?.consensus?.iterations || 0)
+  );
+  const unanimous = explicitUnanimous && required.every((id) => agreed.has(id));
+  return {
+    unanimous,
+    iterations,
+    agreed_count: agreed.size,
+    required_count: required.length,
+    missing: required.filter((id) => !agreed.has(id))
+  };
+}
+
 export function defaultResearchGate() {
   return {
     passed: false,
@@ -500,6 +528,8 @@ export function defaultResearchGate() {
     scout_findings: 0,
     debate_participants: 0,
     debate_exchanges: 0,
+    consensus_iterations: 0,
+    unanimous_consensus: false,
     counterevidence_sources: 0,
     candidate_insights: 0,
     falsification_passes: 0,
@@ -532,6 +562,8 @@ export async function evaluateResearchGate(dir) {
   const scoutLedger = await readJson(path.join(dir, 'scout-ledger.json'), null);
   const debateLedger = await readJson(path.join(dir, 'debate-ledger.json'), null);
   const falsificationLedger = await readJson(path.join(dir, 'falsification-ledger.json'), null);
+  const geniusSummaryText = geniusSummaryPresent ? await readText(path.join(dir, RESEARCH_GENIUS_SUMMARY_ARTIFACT), '') : '';
+  const personaValidation = validateResearchScoutPersonas(scoutLedger || {}, geniusSummaryText);
   const sourceEntries = Array.isArray(sourceLedger?.sources) ? sourceLedger.sources.length : 0;
   const counterEvidenceEntries = Array.isArray(sourceLedger?.counterevidence_sources) ? sourceLedger.counterevidence_sources.length : 0;
   const webSearchPasses = Math.max(Number(gate.web_search_passes || 0), Number(sourceLedger?.web_search_passes || 0));
@@ -546,6 +578,7 @@ export async function evaluateResearchGate(dir) {
   const debateRows = Array.isArray(debateLedger?.exchanges) ? debateLedger.exchanges : [];
   const debateParticipants = new Set(debateRows.flatMap((exchange) => [exchange?.from, exchange?.to, ...(Array.isArray(exchange?.participants) ? exchange.participants : [])].filter(Boolean))).size;
   const debateExchanges = debateRows.length;
+  const consensus = consensusStats(debateLedger, gate);
   const falsificationCases = Array.isArray(falsificationLedger?.cases) ? falsificationLedger.cases.length : 0;
   const searchBlockers = [
     ...(Array.isArray(gate.web_search_blockers) ? gate.web_search_blockers : []),
@@ -571,9 +604,12 @@ export async function evaluateResearchGate(dir) {
   if (Math.max(Number(gate.independent_scouts || 0), independentScouts) < RESEARCH_SCOUT_COUNCIL.length) reasons.push('independent_scouts_missing');
   if (Math.max(Number(gate.xhigh_scouts || 0), xhighScouts) < RESEARCH_SCOUT_COUNCIL.length) reasons.push('scout_effort_not_xhigh');
   if (Math.max(Number(gate.eureka_moments || 0), eurekaMoments) < RESEARCH_SCOUT_COUNCIL.length) reasons.push('eureka_missing');
+  if (!personaValidation.ok) reasons.push(...personaValidation.issues.map((issue) => `scout_persona:${issue}`));
   if (Math.max(Number(gate.scout_findings || 0), scoutFindings) < 4) reasons.push('scout_findings_missing');
   if (Math.max(Number(gate.debate_participants || 0), debateParticipants) < RESEARCH_SCOUT_COUNCIL.length) reasons.push('debate_participants_missing');
   if (Math.max(Number(gate.debate_exchanges || 0), debateExchanges) < RESEARCH_SCOUT_COUNCIL.length) reasons.push('debate_exchanges_missing');
+  if (Math.max(Number(gate.consensus_iterations || 0), consensus.iterations) < 1) reasons.push('consensus_iteration_missing');
+  if (!consensus.unanimous) reasons.push('unanimous_consensus_missing');
   if (Math.max(Number(gate.counterevidence_sources || 0), counterEvidenceEntries) < 1) reasons.push('counterevidence_source_missing');
   if ((gate.candidate_insights || 0) < 1) reasons.push('candidate_insight_missing');
   if ((gate.falsification_passes || 0) < 1) reasons.push('falsification_missing');
@@ -601,9 +637,15 @@ export async function evaluateResearchGate(dir) {
       independent_scouts: Math.max(Number(gate.independent_scouts || 0), independentScouts),
       xhigh_scouts: Math.max(Number(gate.xhigh_scouts || 0), xhighScouts),
       eureka_moments: Math.max(Number(gate.eureka_moments || 0), eurekaMoments),
+      scout_persona_contract_ok: personaValidation.ok,
+      scout_persona_issues: personaValidation.issues,
       scout_findings: Math.max(Number(gate.scout_findings || 0), scoutFindings),
       debate_participants: Math.max(Number(gate.debate_participants || 0), debateParticipants),
       debate_exchanges: Math.max(Number(gate.debate_exchanges || 0), debateExchanges),
+      consensus_iterations: Math.max(Number(gate.consensus_iterations || 0), consensus.iterations),
+      unanimous_consensus: consensus.unanimous,
+      consensus_agreed_scouts: consensus.agreed_count,
+      consensus_missing_scouts: consensus.missing,
       counterevidence_sources: Math.max(Number(gate.counterevidence_sources || 0), counterEvidenceEntries),
       falsification_cases: Math.max(Number(gate.falsification_cases || 0), falsificationCases),
       citation_coverage: citationCoverage,
@@ -709,12 +751,18 @@ export async function writeMockResearchResult(dir, plan) {
     ...defaultScoutLedger(plan),
     scouts: RESEARCH_SCOUT_COUNCIL.map((scout) => ({
       id: scout.id,
+      display_name: scout.display_name || scout.label,
+      historical_inspiration: scout.historical_inspiration || null,
+      persona: scout.persona || scout.role,
+      persona_boundary: scout.persona_boundary,
       role: scout.role,
       mandate: scout.mandate,
       effort: 'xhigh',
+      reasoning_effort: 'xhigh',
+      service_tier: scout.service_tier || 'fast',
       eureka: {
         exclamation: 'Eureka!',
-        idea: `${scout.label} spots a non-obvious, testable angle for ${plan.prompt}.`,
+        idea: `${scout.display_name || scout.label} spots a non-obvious, testable angle for ${plan.prompt}.`,
         why_it_matters: 'It forces the run to produce one falsifiable idea before synthesis.',
         source_ids: ['mock-source-1']
       },
@@ -722,13 +770,14 @@ export async function writeMockResearchResult(dir, plan) {
       findings: [
         {
           id: `mock-${scout.id}-finding-1`,
-          claim: `${scout.label} supports a source-cited, falsifiable research gate for ${plan.prompt}.`,
+          claim: `${scout.display_name || scout.label} supports a source-cited, falsifiable research gate for ${plan.prompt}.`,
           source_ids: ['mock-source-1'],
           status: 'mock_supported'
         }
       ],
       falsifiers: ['A run without cited sources, counterevidence, or cheap probes should fail the research gate.'],
-      cheap_probes: ['Compare discovery-loop output against a summary-only baseline and count testable insights.']
+      cheap_probes: ['Compare discovery-loop output against a summary-only baseline and count testable insights.'],
+      challenge_or_response: 'Participated in the mock evidence-bound debate.'
     })),
     synthesis: {
       surviving_claims: ['mock-insight-1'],
@@ -739,8 +788,16 @@ export async function writeMockResearchResult(dir, plan) {
   const debateLedger = {
     schema_version: 1,
     created_at: nowIso(),
-    mode: 'vigorous_evidence_bound_debate',
+    mode: 'vigorous_evidence_bound_debate_until_unanimous_consensus',
     required_participants: RESEARCH_SCOUT_COUNCIL.map((scout) => scout.id),
+    consensus_iterations: 2,
+    unanimous_consensus: true,
+    scout_agreements: RESEARCH_SCOUT_COUNCIL.map((scout) => ({
+      scout_id: scout.id,
+      agrees: true,
+      final_position: 'Agrees to keep the falsifiable, source-cited research mechanism as the surviving claim.',
+      source_ids: ['mock-source-1', 'mock-counter-1']
+    })),
     exchanges: [
       { id: 'mock-debate-1', from: 'einstein', to: 'feynman', stance: 'challenge', claim: 'A toy probe is not enough unless it preserves the invariant.', source_ids: ['mock-source-1'] },
       { id: 'mock-debate-2', from: 'feynman', to: 'turing', stance: 'challenge', claim: 'A formal gate must still be explainable as a cheap experiment.', source_ids: ['mock-source-1'] },
@@ -793,8 +850,8 @@ export async function writeMockResearchResult(dir, plan) {
     '',
     '## Scout Opinions',
     ...RESEARCH_SCOUT_COUNCIL.flatMap((scout) => [
-      `### ${scout.label} (${scout.id})`,
-      `Final opinion: ${scout.label} wants the run to preserve ${scout.mandate.toLowerCase()} while producing a cited, falsifiable insight.`,
+      `### ${scout.display_name || scout.label} (${scout.id})`,
+      `Final opinion: ${scout.display_name || scout.label} wants the run to preserve ${scout.mandate.toLowerCase()} while producing a cited, falsifiable insight.`,
       'Strongest evidence: mock-source-1 plus the layered source ledger.',
       'Main disagreement: whether formal structure or cheap empirical probes should dominate the first pass.',
       'Changed mind: accepted that citation coverage, counterevidence, and triangulation are gates before synthesis.',
@@ -831,13 +888,15 @@ export async function writeMockResearchResult(dir, plan) {
     source_layers_required: RESEARCH_SOURCE_LAYER_IDS.length,
     source_layers_covered: RESEARCH_SOURCE_LAYER_IDS.length,
     triangulation_checks: sourceLedger.triangulation.cross_layer_checks.length,
-    independent_scouts: RESEARCH_SCOUT_COUNCIL.length,
-    xhigh_scouts: RESEARCH_SCOUT_COUNCIL.length,
-    eureka_moments: RESEARCH_SCOUT_COUNCIL.length,
-    scout_findings: RESEARCH_SCOUT_COUNCIL.length,
-    debate_participants: RESEARCH_SCOUT_COUNCIL.length,
-    debate_exchanges: debateLedger.exchanges.length,
-    counterevidence_sources: 1,
+	    independent_scouts: RESEARCH_SCOUT_COUNCIL.length,
+	    xhigh_scouts: RESEARCH_SCOUT_COUNCIL.length,
+	    eureka_moments: RESEARCH_SCOUT_COUNCIL.length,
+	    scout_findings: RESEARCH_SCOUT_COUNCIL.length,
+	    debate_participants: RESEARCH_SCOUT_COUNCIL.length,
+	    debate_exchanges: debateLedger.exchanges.length,
+	    consensus_iterations: debateLedger.consensus_iterations,
+	    unanimous_consensus: true,
+	    counterevidence_sources: 1,
     candidate_insights: 1,
     falsification_passes: 1,
     falsification_cases: 1,
@@ -850,5 +909,5 @@ export async function writeMockResearchResult(dir, plan) {
 }
 
 export function buildResearchPrompt({ id, mission, plan, cycle, previous }) {
-  return `You are running SKS Research Mode.\nMISSION: ${id}\nTOPIC: ${mission.prompt}\nCYCLE: ${cycle}\nMODE: Genius Scout Council + frontier discovery loop. Use maximum reasoning depth available under the current Codex profile.\nLONG-RUN REAL-RESEARCH POLICY: Normal Research is allowed to take one or two hours when the question requires it. Do real source gathering and evidence comparison; do not shortcut into mock, fixture, or summary-only output. If live source access is unavailable, write the blocker and keep the gate unpassed.\nNO-QUESTION LOCK: Do not ask the user. Resolve scope from research-plan.json and current project evidence.\nSAFETY: Destructive database operations and unsafe external actions are forbidden. Prefer read-only inspection, local files, and cited public sources.\nPERSONA POLICY: Use Einstein/Feynman/Turing/von Neumann-inspired scout lenses only as cognitive roles. Do not impersonate, roleplay private identity, or speak as the historical people.\nSCOUT EFFORT POLICY: Every Research scout agent must use reasoning_effort=xhigh. Record effort: "xhigh" for every scout in scout-ledger.json. Any lower-effort scout output must keep research-gate.json unpassed.\nEUREKA POLICY: Every scout must literally write "Eureka!" and one non-obvious, source-linked idea before debate.\nDEBATE POLICY: The scouts must debate vigorously but stay evidence-bound. Every scout must challenge or respond at least once, and debate-ledger.json must record the exchanges before synthesis.\nPAPER POLICY: After the report and ledgers, write research-paper.md as a concise manuscript with Abstract, Introduction, Methodology, Findings/Results, Discussion, Limitations/Falsification, Conclusion/Next Experiment, and References.\nSOURCE SKILL POLICY: Create or update ${RESEARCH_SOURCE_SKILL_ARTIFACT} as a route-local source collection skill before synthesis. It must name the selected source layers, query routes, quality fields, blockers, and cross-layer triangulation checks. Do not edit generated .agents/skills during the research run.\nWEB/SOURCE POLICY: Run layered source retrieval across every safely available layer before synthesis: latest public papers, official government or leading-institution data, standards or primary docs, current news including BBC/CNN/GDELT-style sources when relevant, public discourse including X/Twitter and Reddit when available, developer/practitioner sources such as Stack Overflow/Stack Exchange/GitHub, and counterevidence or fact-checking sources. Treat public discourse as signal, not truth. If a layer cannot be searched, record the blocker in source-ledger.json and do not pass the gate.\nRESEARCH PLAN:\n${JSON.stringify(plan, null, 2)}\n\nOBJECTIVE: Produce genuinely useful candidate discoveries: non-obvious hypotheses, mechanisms, predictions, or experiments. Do not merely summarize. Mark uncertainty clearly.\n\nREQUIRED PROCESS:\n1. Source skill first: create ${RESEARCH_SOURCE_SKILL_ARTIFACT} with source layers, query templates, quality fields, blockers, and triangulation rules.\n2. Layered source search: create source-ledger.json with source_layers, queries, source ids, source quality notes, counterevidence sources, triangulation.cross_layer_checks, citation coverage, and blockers.\n3. Independent xhigh scouts: create scout-ledger.json with effort=xhigh, a literal Eureka! idea, findings, source_ids, falsifiers, and cheap_probes for every scout lens.\n4. Debate: create debate-ledger.json with evidence-bound challenge/response exchanges involving every scout before synthesis.\n5. Falsification: create falsification-ledger.json with attacks, missing evidence, source conflicts, and decisive next tests.\n6. Synthesis: write research-report.md and novelty-ledger.json only after cited scout findings, Eureka ideas, debate, cross-layer triangulation, and falsification are recorded.\n7. Paper: write research-paper.md as a paper-style manuscript with source-ledger references and limitations.\n\nREQUIRED OUTPUT FILES in .sneakoscope/missions/${id}/:\n- research-report.md: concise report with framing, source coverage, scout synthesis, debate synthesis, hypotheses, falsification, predictions, and next experiments. Cite source-ledger ids for factual claims.\n- research-paper.md: paper manuscript with Abstract, Introduction, Methodology, Findings/Results, Discussion, Limitations/Falsification, Conclusion/Next Experiment, and References using source-ledger ids.\n- ${RESEARCH_SOURCE_SKILL_ARTIFACT}: route-local source collection skill; it is evidence for the Skill Creator step and must not mutate generated .agents/skills.\n- source-ledger.json: layered web/source queries, source ids, source priority, source quality notes, counterevidence sources, citation coverage, triangulation checks, and blockers.\n- scout-ledger.json: one entry per scout lens with effort, eureka, query_set, findings, source_ids, falsifiers, and cheap_probes.\n- debate-ledger.json: evidence-bound challenge/response exchanges, participants, changed minds, and unresolved conflicts.\n- novelty-ledger.json: entries with claim, novelty, confidence, falsifiability, evidence source ids, falsifiers, next_experiment.\n- falsification-ledger.json: attacks/counterexamples/source conflicts, result, and next_decisive_tests.\n- research-gate.json: set passed only when all ledgers exist, ${RESEARCH_SOURCE_SKILL_ARTIFACT} exists, research-paper.md exists with required paper sections, layered web/source retrieval covered every required source layer, at least one cross-layer triangulation check exists, all scouts have effort=xhigh, all scouts have literal Eureka! ideas, every scout participated in debate, at least one counterevidence source exists, citation coverage is complete, at least one insight survived falsification, at least one testable prediction exists, and unsupported breakthrough claims are zero.\n\nPrevious cycle tail:\n${String(previous || '').slice(-2500)}\n`;
+  return `You are running SKS Research Mode.\nMISSION: ${id}\nTOPIC: ${mission.prompt}\nCYCLE: ${cycle}\nMODE: Genius Scout Council + frontier discovery loop. Use maximum reasoning depth available under the current Codex profile.\nLONG-RUN REAL-RESEARCH POLICY: Normal Research is allowed to take one or two hours when the question requires it. Do real source gathering and evidence comparison; do not shortcut into mock, fixture, or summary-only output. If live source access is unavailable, write the blocker and keep the gate unpassed.\nNO-CODE-MUTATION POLICY: Do not edit repository source, package metadata, docs, config, generated skills, or harness files. Write only route-local artifacts under .sneakoscope/missions/${id}/. If a needed implementation change is discovered, record it as a recommendation or blocker for a later execution route.\nNO-QUESTION LOCK: Do not ask the user. Resolve scope from research-plan.json and current project evidence.\nSAFETY: Destructive database operations and unsafe external actions are forbidden. Prefer read-only inspection, local files, and cited public sources.\nPERSONA POLICY: Use Einstein/Feynman/Turing/von Neumann-inspired scout lenses only as cognitive roles. Do not impersonate, roleplay private identity, or speak as the historical people.\nSCOUT PERSONA POLICY: Every Research scout row must include display_name, persona, persona_boundary, reasoning_effort: "xhigh", service_tier when available, falsifiers, cheap_probes, and challenge_or_response. Persona names are Einstein Scout, Feynman Scout, Turing Scout, von Neumann Scout, and Skeptic Scout; they are cognitive lenses, not impersonations.\nSCOUT EFFORT POLICY: Every Research scout agent must use reasoning_effort=xhigh. Record effort: "xhigh" for every scout in scout-ledger.json. Any lower-effort scout output must keep research-gate.json unpassed.\nEUREKA POLICY: Every scout must literally write "Eureka!" and one non-obvious, source-linked idea before debate.\nCONSENSUS LOOP POLICY: This is not a fixed three-cycle run. Repeat source-gathering, scout Eureka ideas, debate, falsification, and synthesis pressure until every scout records final agreement with the surviving mechanism. If unanimous agreement is not reached, keep research-gate.json unpassed and continue until the explicit max-cycle safety cap pauses the run.\nDEBATE POLICY: The scouts must debate vigorously but stay evidence-bound. Every scout must challenge or respond at least once, and debate-ledger.json must record exchanges, consensus_iterations, unanimous_consensus, and per-scout agreements before synthesis.\nPAPER POLICY: After the report and ledgers, write research-paper.md as a concise manuscript with Abstract, Introduction, Methodology, Findings/Results, Discussion, Limitations/Falsification, Conclusion/Next Experiment, and References.\nSOURCE SKILL POLICY: Create or update ${RESEARCH_SOURCE_SKILL_ARTIFACT} as a route-local source collection skill before synthesis. It must name the selected source layers, query routes, quality fields, blockers, and cross-layer triangulation checks. Do not edit generated .agents/skills during the research run.\nWEB/SOURCE POLICY: Run layered source retrieval across every safely available layer before synthesis: latest public papers, official government or leading-institution data, standards or primary docs, current news including BBC/CNN/GDELT-style sources when relevant, public discourse including X/Twitter and Reddit when available, developer/practitioner sources such as Stack Overflow/Stack Exchange/GitHub, and counterevidence or fact-checking sources. Treat public discourse as signal, not truth. If a layer cannot be searched, record the blocker in source-ledger.json and do not pass the gate.\nRESEARCH PLAN:\n${JSON.stringify(plan, null, 2)}\n\nOBJECTIVE: Produce genuinely useful candidate discoveries: non-obvious hypotheses, mechanisms, predictions, or experiments. Do not merely summarize. Mark uncertainty clearly.\n\nREQUIRED PROCESS:\n1. Source skill first: create ${RESEARCH_SOURCE_SKILL_ARTIFACT} with source layers, query templates, quality fields, blockers, and triangulation rules.\n2. Layered source search: create source-ledger.json with source_layers, queries, source ids, source quality notes, counterevidence sources, triangulation.cross_layer_checks, citation coverage, and blockers.\n3. Independent xhigh scouts: create scout-ledger.json with display_name/persona/persona_boundary, effort=xhigh, reasoning_effort=xhigh, a literal Eureka! idea, findings, source_ids, falsifiers, cheap_probes, and challenge_or_response for every scout lens.\n4. Debate to agreement: create debate-ledger.json with evidence-bound challenge/response exchanges involving every scout, consensus_iterations >= 1, unanimous_consensus=true only when all scouts agree, and scout_agreements for every scout.\n5. Falsification: create falsification-ledger.json with attacks, missing evidence, source conflicts, and decisive next tests.\n6. Synthesis: write research-report.md and novelty-ledger.json only after cited scout findings, Eureka ideas, unanimous debate agreement, cross-layer triangulation, and falsification are recorded.\n7. Paper: write research-paper.md as a paper-style manuscript with source-ledger references and limitations.\n\nREQUIRED OUTPUT FILES in .sneakoscope/missions/${id}/:\n- research-report.md: concise report with framing, source coverage, scout synthesis, debate synthesis, hypotheses, falsification, predictions, and next experiments. Cite source-ledger ids for factual claims.\n- research-paper.md: paper manuscript with Abstract, Introduction, Methodology, Findings/Results, Discussion, Limitations/Falsification, Conclusion/Next Experiment, and References using source-ledger ids.\n- ${RESEARCH_SOURCE_SKILL_ARTIFACT}: route-local source collection skill; it is evidence for the Skill Creator step and must not mutate generated .agents/skills.\n- source-ledger.json: layered web/source queries, source ids, source priority, source quality notes, counterevidence sources, citation coverage, triangulation checks, and blockers.\n- scout-ledger.json: one entry per scout lens with display_name, persona, persona_boundary, effort, reasoning_effort, service_tier, eureka, query_set, findings, source_ids, falsifiers, cheap_probes, and challenge_or_response.\n- debate-ledger.json: evidence-bound challenge/response exchanges, participants, changed minds, unresolved conflicts, consensus_iterations, unanimous_consensus, and scout_agreements for every scout.\n- novelty-ledger.json: entries with claim, novelty, confidence, falsifiability, evidence source ids, falsifiers, next_experiment.\n- falsification-ledger.json: attacks/counterexamples/source conflicts, result, and next_decisive_tests.\n- research-gate.json: set passed only when all ledgers exist, ${RESEARCH_SOURCE_SKILL_ARTIFACT} exists, research-paper.md exists with required paper sections, layered web/source retrieval covered every required source layer, at least one cross-layer triangulation check exists, all scouts have display_name/persona/persona_boundary, all scouts have effort=xhigh, all scouts have literal Eureka! ideas, every scout participated in debate, consensus_iterations >= 1, unanimous_consensus=true with every scout agreement recorded, at least one counterevidence source exists, citation coverage is complete, at least one insight survived falsification, at least one testable prediction exists, and unsupported breakthrough claims are zero.\n\nPrevious cycle tail:\n${String(previous || '').slice(-2500)}\n`;
 }

package/src/core/routes.mjs

@@ -399,7 +399,7 @@ export const ROUTES = [
     command: '$Research',
     mode: 'RESEARCH',
     route: 'research mission',
-    description: 'Frontier discovery with xhigh genius-lens scouts, Eureka ideas, vigorous evidence-bound debate, layered public source retrieval, falsification, a paper manuscript, a final genius-opinion summary, and testable predictions.',
+    description: 'Frontier discovery with named xhigh persona-lens scouts, Eureka ideas, vigorous evidence-bound debate, layered public source retrieval, falsification, a paper manuscript, a final genius-opinion summary, and testable predictions.',
     requiredSkills: ['research', 'research-discovery', 'pipeline-runner', REFLECTION_SKILL_NAME, 'honest-mode'],
     lifecycle: ['research_plan', 'source_skill', 'layered_source_ledger', 'xhigh_scout_council', 'eureka_moments', 'debate_ledger', 'report', 'paper', 'genius_opinion_summary', 'novelty_ledger', 'falsification_ledger', 'research_gate', 'post_route_reflection', 'honest_mode'],
     context7Policy: 'if_external_docs',
@@ -521,7 +521,7 @@ export const COMMAND_CATALOG = [
   { name: 'quickstart', usage: 'sks quickstart', description: 'Show the shortest safe setup and verification flow.' },
   { name: 'bootstrap', usage: 'sks bootstrap [--install-scope global|project] [--local-only] [--json]', description: 'Initialize the current project, install SKS Codex App files/skills, check Context7/Codex App/tmux, and print ready true/false.' },
   { name: 'root', usage: 'sks root [--json]', description: 'Show whether SKS is using a project root or the per-user global SKS runtime root.' },
-  { name: 'deps', usage: 'sks deps check|install [tmux|codex|context7|all] [--yes]', description: 'Check or guided-install Node/npm PATH, Codex CLI/App, Context7, Browser Use, Computer Use, tmux, and Homebrew on macOS.' },
+  { name: 'deps', usage: 'sks deps check|install [tmux|codex|context7|all] [--yes]', description: 'Check or guided-install Node/npm PATH, Codex CLI/App, Context7, Browser tooling, Computer Use, tmux, and Homebrew on macOS.' },
   { name: 'codex-app', usage: 'sks codex-app [check|open|remote-control]', description: 'Check Codex App install and first-party MCP/plugin readiness, then show app setup files, examples, and Codex CLI 0.130.0+ remote-control availability.' },
   { name: 'codex-lb', usage: 'sks codex-lb status|health|repair|setup --host <domain> --api-key <key>', description: 'Configure, health-check, or repair codex-lb Codex CLI auth by writing ~/.codex/config.toml, syncing auth.json, and loading the CODEX_LB_API_KEY env file.' },
   { name: 'auth', usage: 'sks auth status|health|repair|setup --host <domain> --api-key <key>', description: 'Shortcut for codex-lb auth status, health, repair, and setup commands.' },
@@ -535,6 +535,7 @@ export const COMMAND_CATALOG = [
   { name: 'ppt', usage: 'sks ppt build|status <mission-id|latest> [--json]', description: 'Build or inspect $PPT HTML/PDF artifacts from a sealed presentation decision contract.' },
   { name: 'image-ux-review', usage: 'sks image-ux-review status <mission-id|latest> [--json]', description: 'Inspect $Image-UX-Review gpt-image-2/imagegen annotated UI/UX review artifacts.' },
   { name: 'context7', usage: 'sks context7 check|setup|tools|resolve|docs|evidence ...', description: 'Check, configure, and call the local Context7 MCP requirement.' },
+  { 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.' },
   { name: 'conflicts', usage: 'sks conflicts check|prompt [--json]', description: 'Detect other Codex harnesses such as OMX/DCodex and print the GPT-5.5 high cleanup prompt.' },