winter-super-cli 2026.6.24 → 2026.6.27

package/src/cli/prompt-builder.js

@@ -1,5 +1,7 @@
 import { formatRuntimeEnvironmentSummary, getRuntimeEnvironment } from './runtime-env.js';
+import { buildHermesCoreContract } from '../ai/hermes-core.js';
 import { getModelBudgetMultiplier } from '../ai/model-capabilities.js';
+import { buildCodingMasteryContract } from '../ai/small-model-amplifier.js';
 
 /**
  * PromptBuilder — Builds system prompts for Winter CLI agents.
@@ -44,18 +46,26 @@ export class PromptBuilder {
     return typeof value === 'string' ? value : '';
   }
 
+  getResourceApplicationProfile() {
+    const sessionContext = this.session?.getContext?.() || {};
+    const value = sessionContext.resourceApplicationProfile?.value ?? sessionContext.resourceApplicationProfile;
+    return typeof value === 'string' ? value : '';
+  }
+
   buildSystemPrompt(context = '', options = {}) {
     const memories = this.session?.getMemory?.() || [];
     const plans = this.session?.getPlans?.() || [];
     const sessionContext = this.session?.getContext?.() || {};
     const environmentSummary = this.tools?.getRuntimeEnvironmentSummary?.() || this._defaultEnvironmentSummary();
     const requiredLocalResources = this.getRequiredLocalResources();
+    const resourceApplicationProfile = this.getResourceApplicationProfile();
     const scale = getModelBudgetMultiplier(options.modelTier);
     const projectContextBudget = options.projectContextBudget || Math.round(3200 * scale);
     const compactSystemPrompt = options.compactSystemPrompt ?? (scale <= 0.75);
     const memoryBudget = Math.round(1200 * scale);
     const planBudget = Math.round(1200 * scale);
     const requiredResourcesBudget = Math.round((compactSystemPrompt ? 1200 : 1600) * scale);
+    const resourceProfileBudget = Math.round((compactSystemPrompt ? 1800 : 2600) * scale);
     const workflowBudget = Math.round(900 * scale);
     const blueprintBudget = Math.round(700 * scale);
 
@@ -65,6 +75,9 @@ export class PromptBuilder {
     const requiredResourcesStr = requiredLocalResources
       ? `\n## Required Local Resource Rules\n${this._compactText(requiredLocalResources, requiredResourcesBudget, 'required local resources')}`
       : '';
+    const resourceProfileStr = resourceApplicationProfile
+      ? `\n## Auto-loaded Resource Application Profile\n${this._compactText(resourceApplicationProfile, resourceProfileBudget, 'resource application profile')}`
+      : '';
     const plansStr = plans.length > 0
       ? this._formatPlans(plans, { maxTotalChars: planBudget })
       : '';
@@ -77,6 +90,11 @@ export class PromptBuilder {
     const blueprintStr = sessionContext.workflowBlueprint
       ? `\n## Profile Blueprint\n${this._compactText(sessionContext.workflowBlueprint, blueprintBudget, 'workflow blueprint')}`
       : '';
+    const smallModelContractStr = compactSystemPrompt
+      ? '\n## Small Model Operating Contract\n- Use a private checklist: goal, files/state to inspect, next tool, verification.\n- For action tasks, make one concrete tool call before claiming progress.\n- If unsure, Read/Grep/Glob/Bash instead of guessing.\n- Do not claim files changed, browser checked, tests passed, or commands ran without tool output from this turn.\n- Keep context reads small and high-signal; verify after changes.'
+      : '';
+    const codingMasteryStr = `\n${buildCodingMasteryContract({ compact: compactSystemPrompt })}`;
+    const hermesCoreStr = `\n${buildHermesCoreContract({ compact: compactSystemPrompt })}`;
     const startupPlanStr = sessionContext.bootstrapPlan?.title
       ? `\n## Startup Plan\n- ${sessionContext.bootstrapPlan.title}: ${sessionContext.bootstrapPlan.description}`
       : '';
@@ -93,7 +111,7 @@ export class PromptBuilder {
         `CRITICAL: You MUST call tools (Read/Write/Edit/Bash) to do real work. NEVER write code in markdown and claim done. Winter blocks fake completions.`,
         `Tool fallback when native calls are unavailable: <invoke name="Read"><parameter name="path">README.md</parameter></invoke> OR {"tool":"Read","arguments":{"path":"README.md"}} OR CALL_TOOL Read {"path":"README.md"}.`,
         `Session: cwd=${this.projectPath}; id=${this.session?.getSessionId?.()?.substring(0, 8) || 'unknown'}`,
-        `${requiredResourcesStr}${memoryStr}${plansStr}${skillsStr}${workflowStr}${blueprintStr}${startupPlanStr}${sessionSignalsStr}`,
+        `${smallModelContractStr}${codingMasteryStr}${hermesCoreStr}${requiredResourcesStr}${resourceProfileStr}${memoryStr}${plansStr}${skillsStr}${workflowStr}${blueprintStr}${startupPlanStr}${sessionSignalsStr}`,
         context ? `\n## Project Context\n${this._compactText(context, projectContextBudget, 'project context')}` : '',
       ].filter(Boolean).join('\n');
     }
@@ -117,12 +135,18 @@ export class PromptBuilder {
       `Prefer Read/Grep/Glob before editing. Use Write/Edit for file changes.`,
       `CRITICAL: When the user asks you to fix/create/edit/run/modify anything, you MUST call tools (Read, Write, Edit, Bash, etc.) to actually do it. NEVER just write code in a markdown code block and claim it is done. Winter will detect and block fake completions. If you say "đã sửa/đã tạo/done/fixed" without a tool call, your response will be rejected.`,
       `Tool call compatibility: if native tool calls are unavailable, output exactly one of these forms and no prose: <invoke name="Read"><parameter name="path">README.md</parameter></invoke> OR {"tool":"Read","arguments":{"path":"README.md"}} OR CALL_TOOL Read {"path":"README.md"}.`,
-      `Browser capability: You CAN browse URLs! Use WebFetch to fetch page content (text extraction) or BrowserDebug for Chrome automation (JS rendering, screenshots). If user shares a URL or asks to view a website, use these tools automatically.`,
+      `Open browser requests: if the user asks to "mở chrome", "open Chrome", or open a URL in a visible browser, use OpenBrowser. Do NOT use Bash, Get-Command, Start-Process, cmd start, or shell app launch commands for this.`,
+      `Browser capability: You CAN browse URLs! Use WebFetch only for static page text extraction. For live Chrome debugging and visible browser control, prefer MCP server "chrome-devtools" when configured: use MCP tool "new_page" or "navigate_page", then "take_snapshot", "click", "fill"/"fill_form", "take_screenshot", "evaluate_script", "list_console_messages", "list_network_requests", or performance trace tools. If MCP is unavailable, use VisibleBrowser for real visible Puppeteer control. BrowserDebug is headless fallback only when visible control is unnecessary.`,
+      `Browser interaction rule: if the user asks to click, press, fill, select, submit, open a web app path, or inspect page-by-page data, WebFetch is not enough and BrowserDebug is not user-visible. Use chrome-devtools MCP or VisibleBrowser so the user can watch a normal browser. Never claim "đã bấm/đã điền/đã mở/đã kiểm tra" from prose alone.`,
       `When a task touches coding, agents, UI, brand, or design, inspect the relevant required local resource in depth before deciding.`,
       `If the user asks you to modify, run, inspect, check, publish, commit, or otherwise act on the project, you MUST use tools. Do not claim completion without a tool result from this turn.`,
       ``,
+      buildCodingMasteryContract(),
+      ``,
+      buildHermesCoreContract(),
+      ``,
       `## Debug Excellence`,
-      `For bugs, crashes, test failures, or "not working": identify the first hard failure, reproduce or inspect logs, trace the exact runtime path, patch the smallest root cause, and verify with the closest command. For frontend/runtime UI issues, use BrowserDebug when a URL or dev server is available.`,
+      `For bugs, crashes, test failures, or "not working": identify the first hard failure, reproduce or inspect logs, trace the exact runtime path, patch the smallest root cause, and verify with the closest command. For frontend/runtime UI issues with a URL/dev server, prefer chrome-devtools MCP in visible Chrome; use BrowserDebug only as a headless fallback.`,
       ``,
       `## Design Excellence`,
       `For UI/design work: inspect existing components/styles and any design resources first. Build a polished, responsive, domain-appropriate interface with complete states and clear interactions. Avoid generic placeholders, fake controls, one-note palettes, and unverified visual claims.`,
@@ -133,7 +157,7 @@ export class PromptBuilder {
       `## Session`,
       `Working directory: ${this.projectPath}`,
       `Current session: ${this.session?.getSessionId?.()?.substring(0, 8) || 'unknown'}`,
-      `${requiredResourcesStr}${memoryStr}${plansStr}${skillsStr}${workflowStr}${blueprintStr}${startupPlanStr}${sessionSignalsStr}`,
+      `${requiredResourcesStr}${resourceProfileStr}${memoryStr}${plansStr}${skillsStr}${workflowStr}${blueprintStr}${startupPlanStr}${sessionSignalsStr}`,
       context ? `\n## Project Context\n${this._compactText(context, projectContextBudget, 'project context')}` : '',
       ``,
       `Be helpful, be precise, and get things done. Always respond in Vietnamese.`,
@@ -143,9 +167,13 @@ export class PromptBuilder {
   buildFastSystemPrompt() {
     const memories = this.session?.getMemory?.() || [];
     const requiredLocalResources = this.getRequiredLocalResources();
+    const resourceApplicationProfile = this.getResourceApplicationProfile();
     const requiredResourcesStr = requiredLocalResources
       ? `\nQuy tac resource bat buoc:\n${this._compactText(requiredLocalResources, 900, 'required local resources')}`
       : '';
+    const resourceProfileStr = resourceApplicationProfile
+      ? `\nResource profile tu dong nap:\n${this._compactText(resourceApplicationProfile, 1100, 'resource application profile')}`
+      : '';
     const memoryStr = memories.length > 0
       ? `\nContext nhớ ngắn:\n${this._summarizePrompts(memories.slice(-8), {
           limit: 8,
@@ -164,6 +192,7 @@ export class PromptBuilder {
       'Nếu có ảnh/screenshot đính kèm hoặc paste từ clipboard, phân tích trực tiếp ảnh đó.',
       'Luôn tuân thủ Required Local Resource Rules nếu có; không hạ chất lượng theo model.',
       requiredResourcesStr,
+      resourceProfileStr,
       memoryStr,
     ].filter(Boolean).join('\n');
   }
@@ -173,6 +202,7 @@ export class PromptBuilder {
     const plans = this.session?.getPlans?.() || [];
     const sessionContext = this.session?.getContext?.() || {};
     const requiredLocalResources = this.getRequiredLocalResources();
+    const resourceApplicationProfile = this.getResourceApplicationProfile();
     const scale = getModelBudgetMultiplier(this.ai?._modelTier || '');
     const projectContextBudget = Math.round(3200 * (scale || 1));
 
@@ -180,6 +210,9 @@ export class PromptBuilder {
     const requiredResourcesStr = requiredLocalResources
       ? `\n## Required Local Resource Rules\n${this._compactText(requiredLocalResources, Math.round(1600 * (scale || 1)), 'required local resources')}`
       : '';
+    const resourceProfileStr = resourceApplicationProfile
+      ? `\n## Auto-loaded Resource Application Profile\n${this._compactText(resourceApplicationProfile, Math.round(2200 * (scale || 1)), 'resource application profile')}`
+      : '';
     const plansStr = plans.length > 0 ? this._formatPlans(plans, { maxTotalChars: Math.round(900 * (scale || 1)) }) : '';
     const skillsStr = Array.isArray(sessionContext.activeSkills) && sessionContext.activeSkills.length > 0
       ? `\n## Auto-applied Skills\n${sessionContext.activeSkills.slice(0, 12).map(skill => `- ${skill}`).join('\n')}${sessionContext.activeSkills.length > 12 ? '\n- ...' : ''}`
@@ -193,7 +226,7 @@ export class PromptBuilder {
       review: 'You are a Winter review subagent. Critique the request or implementation with specific issues, edge cases, and concrete improvements.',
       debug: 'You are a Winter debugging subagent. Reproduce or inspect the exact failing path, isolate the first hard blocker, patch the smallest root cause, and verify with the closest test/build/browser smoke.',
       research: 'You are a Winter research subagent. Gather the important facts, compare options, and summarize only what matters.',
-      browser: `You are a Winter browser subagent. Bạn CÓ QUYỀN sử dụng tool 'BrowserDebug' để tương tác với trình duyệt. Hãy dùng nó để mở URL, chụp ảnh màn hình (nếu cần), hoặc chạy JS để kiểm tra trang web.`,
+      browser: `You are a Winter browser subagent. Bạn CÓ QUYỀN sử dụng chrome-devtools MCP hoặc VisibleBrowser để thao tác browser visible cho user xem: mở URL, click, fill form, snapshot, screenshot, đọc console/network. Dùng BrowserDebug chỉ khi cần headless fallback.`,
     };
 
     const rolePrompt = rolePrompts[role] || 'You are a Winter coding subagent. Solve the task directly, use tools when needed, and return a concise result.';
@@ -208,14 +241,15 @@ export class PromptBuilder {
       '3. [DEBUG EXCELLENCE]: Reproduce or inspect the failing path first, isolate the first hard blocker, patch root cause, and verify with the closest test/build/browser smoke.',
       '4. [DESIGN EXCELLENCE]: Use rich aesthetics. Default to modern UI frameworks if applicable. Never output plain, ugly HTML/CSS. Ensure responsive, premium feel with micro-animations.',
       '5. [CODE QUALITY]: Write clean, modular, SOLID code. Check for syntax errors carefully. Do not generate incomplete code blocks.',
-      '6. [NO HALLUCINATION]: If you don\'t know, use tools (Grep/Read/Web/BrowserDebug) to find out. Do not guess file paths or APIs.',
+      '6. [NO HALLUCINATION]: If you don\'t know, use tools (Grep/Read/Web/chrome-devtools MCP/VisibleBrowser/BrowserDebug) to find out. Do not guess file paths or APIs.',
       '7. [TOOL EXECUTION FIRST]: You DO have file tools. Use Write to create/overwrite files and Edit to patch files. Never say there is no write tool.',
       '8. [IMAGE INPUTS]: If an image is attached or pasted, analyze it directly and use it as evidence for UI/debug/design decisions.',
       '',
       rolePrompt,
       '',
       '## Tool Rules',
-      '- Canonical tools: Read, Write, Edit, Bash, Glob, Grep, TaskCreate, TaskUpdate, TaskList, BrowserDebug, WebFetch, WebSearch.',
+      '- Canonical tools: Read, Write, Edit, Bash, Glob, Grep, TaskCreate, TaskUpdate, TaskList, OpenBrowser, VisibleBrowser, BrowserDebug, WebFetch, WebSearch, MCP, Agent, DelegateTask, ParallelAgent.',
+      '- For multi-agent work, use DelegateTask for one isolated subagent or ParallelAgent for independent concurrent subagents; do not pretend delegation happened without tool evidence.',
       '- If native tool calls are unavailable, output exactly one fallback tool call and no prose: <invoke name="Read"><parameter name="path">README.md</parameter></invoke> OR {"tool":"Read","arguments":{"path":"README.md"}} OR CALL_TOOL Read {"path":"README.md"}.',
       '- Treat skills, memories, bundled resources, local project rules, and the tool list as operational context. Use them proactively when relevant.',
       `- Runtime environment:\n${runtimeSummary}`,
@@ -223,11 +257,16 @@ export class PromptBuilder {
       '- For action requests, use tools before claiming anything is done. Never claim files changed, tests ran, or checks passed unless this conversation contains the matching tool result.',
       '- If a tool call fails because of an unknown alias, call the canonical tool name next.',
       '- Always start with a brief plan, then refine it when new facts appear.',
+      '- Coding mastery: inspect entrypoint/callers/callees/tests first, preserve invariants, patch minimally, review the diff, and verify with the closest command.',
+      '',
+      buildCodingMasteryContract({ compact: true }),
+      '',
+      buildHermesCoreContract({ compact: true }),
       '',
       '## Project',
       `Working directory: ${this.projectPath}`,
       `Current session: ${this.session?.getSessionId?.()?.substring(0, 8) || 'unknown'}`,
-      `${requiredResourcesStr}${memoryStr}${plansStr}${skillsStr}${startupPlanStr}`,
+      `${requiredResourcesStr}${resourceProfileStr}${memoryStr}${plansStr}${skillsStr}${startupPlanStr}`,
       context ? `\n## Project Context\n${this._compactText(context, projectContextBudget, 'project context')}` : '',
     ].join('\n');
   }

package/src/cli/repl-commands.js

@@ -137,6 +137,88 @@ async function handlePageAgentCommand(repl, args = []) {
   console.log(`${colors.dim}Commands: /page-agent search <query>, /page-agent read <path>, /page-agent docs, /page-agent snippet, /page-agent browse <url>${colors.reset}`);
 }
 
+function parseFlagArgs(args = []) {
+  const parsed = { positional: [] };
+  for (let index = 0; index < args.length; index += 1) {
+    const value = args[index];
+    if (!String(value || '').startsWith('--')) {
+      parsed.positional.push(value);
+      continue;
+    }
+    const key = String(value).slice(2).replace(/-([a-z])/g, (_, char) => char.toUpperCase());
+    const next = args[index + 1];
+    if (!next || String(next).startsWith('--')) {
+      parsed[key] = true;
+      continue;
+    }
+    parsed[key] = next;
+    index += 1;
+  }
+  return parsed;
+}
+
+async function handleBrowserCommand(repl, args = []) {
+  const parsed = parseFlagArgs(args);
+  const [rawAction = 'open', maybeUrl, ...rest] = parsed.positional;
+  const actionAliases = {
+    fill: 'type',
+    inspect: 'snapshot',
+    js: 'evaluate',
+    eval: 'evaluate',
+    screen: 'screenshot',
+    shot: 'screenshot',
+  };
+  const action = actionAliases[String(rawAction).toLowerCase()] || String(rawAction).toLowerCase();
+  const url = parsed.url || (/^https?:\/\//i.test(String(maybeUrl || '')) || String(maybeUrl || '').startsWith('data:') ? maybeUrl : undefined);
+  const trailingText = rest.join(' ').trim();
+  const payload = {
+    action,
+    url: url || 'about:blank',
+    selector: parsed.selector || parsed.css || parsed.target,
+    text: parsed.text || parsed.value || trailingText || undefined,
+    script: parsed.script || parsed.code || (action === 'evaluate' ? trailingText : undefined),
+    wait_for: parsed.waitFor || parsed.wait,
+    screenshot_path: parsed.screenshotPath || parsed.output || parsed.out,
+    keep_open: parsed.keepOpen === true || parsed.keep === true,
+    browser: parsed.browser || 'chrome',
+  };
+
+  if (action === 'help' || action === '--help') {
+    console.log(`${colors.cyan}/browser usage:${colors.reset}`);
+    console.log('  /browser open https://example.com --keep-open');
+    console.log('  /browser click https://example.com --selector button');
+    console.log('  /browser type https://example.com --selector input[name=q] --text winter');
+    console.log('  /browser screenshot https://example.com --output .winter/page.png');
+    console.log('  /browser snapshot https://example.com --selector body');
+    return;
+  }
+
+  if ((action === 'click' || action === 'type') && !payload.selector) {
+    console.log(`${colors.yellow}Usage: /browser ${action} <url> --selector <css>${action === 'type' ? ' --text <value>' : ''}${colors.reset}`);
+    return;
+  }
+  if (action === 'evaluate' && !payload.script) {
+    console.log(`${colors.yellow}Usage: /browser eval <url> --script <javascript>${colors.reset}`);
+    return;
+  }
+
+  console.log(`${colors.cyan}VisibleBrowser:${colors.reset} ${action} ${payload.url}`);
+  const result = await repl.tools.execute('VisibleBrowser', payload, { cwd: repl.projectPath });
+  if (result.success) {
+    console.log(`${colors.green}OK ${result.action || action}: ${result.title || result.url || payload.url}${colors.reset}`);
+    if (result.actionResult !== undefined) {
+      const value = typeof result.actionResult === 'string' ? result.actionResult : JSON.stringify(result.actionResult);
+      console.log(value.length > 2000 ? `${value.slice(0, 2000)}...` : value);
+    }
+    if (result.domSnippet) {
+      console.log(`${colors.dim}${String(result.domSnippet).slice(0, 1200)}${colors.reset}`);
+    }
+    return;
+  }
+  console.log(`${colors.red}FAIL VisibleBrowser: ${result.error || 'unknown error'}${colors.reset}`);
+  if (result.recovery) console.log(`${colors.dim}${result.recovery}${colors.reset}`);
+}
+
 /**
  * Handle slash commands in the Winter REPL.
  * Delegated from WinterREPL.handleSlashCommand to reduce file size.
@@ -381,6 +463,10 @@ export async function handleSlashCommand(repl, input) {
       }
       return;
 
+    case '/browser':
+      await handleBrowserCommand(repl, args);
+      return;
+
     // Inline Completion
     case '/complete':
       if (args.length === 0) {
@@ -531,6 +617,35 @@ export async function handleSlashCommand(repl, input) {
     case '/tui':
       repl.showTuiDashboard();
       return;
+    case '/paste': {
+      const payload = await repl.getClipboardPayload();
+      if (!payload) {
+        console.log(`${colors.yellow}Clipboard is empty or unavailable.${colors.reset}`);
+        return;
+      }
+      if (payload.type === 'image') {
+        const prompt = args.join(' ').trim() || 'Analyze this pasted clipboard image.';
+        await repl.chat(prompt, [payload.image]);
+        return;
+      }
+
+      const prefix = args.join(' ').trim();
+      const text = repl.normalizePastedText(payload.text || '').trim();
+      if (!text) {
+        console.log(`${colors.yellow}Clipboard text is empty.${colors.reset}`);
+        return;
+      }
+      const combined = prefix ? `${prefix}\n\n${text}` : text;
+      if (repl.shouldPersistPastedText(combined)) {
+        const paste = await repl.persistPastedText(combined);
+        const reference = repl.formatPastedTextReference(paste);
+        console.log(`${colors.cyan}│ ${colors.dim}${reference}${colors.reset}`);
+        await repl.handleInput(reference);
+        return;
+      }
+      await repl.handleInput(combined);
+      return;
+    }
 
     // Git Auto-Pilot
     case '/commit':