@serjm/deepseek-code 0.4.1 → 0.4.3

package/CHANGELOG.md

@@ -1,5 +1,34 @@
 # Changelog
 
+## 0.4.3 — Project Mode & Browser Control
+
+### Improvements
+- Improved Chrome browser mode handling.
+- `/chrome --headed` and `/chrome --headless` now switch the desired browser mode without launching Chrome.
+- Browser checks remain headed by default and open visibly unless headless mode is explicitly selected.
+- Browser test reports now show the actual browser mode.
+
+### Agent Quality
+- Added Execution Policy to reduce unnecessary reads, repeated tool calls, temporary files, and over-scoped work.
+- Added Source of Truth Policy to prevent invented versions, release notes, features, links, dates, and metrics.
+- Added Project Acceptance Policy for web/container projects: build alone is not enough; dev server, browser page, error overlay, console, container build, and git hygiene must be checked when relevant.
+- Added Failed Tool Calls Policy: failed commands must be reported and classified as critical or non-critical.
+
+## 0.4.2 — Update Visibility Improvements
+
+### New Features
+- Added startup update notice that checks npm for a newer version.
+- Added 24-hour cooldown to avoid checking npm on every launch.
+- Added `/changelog` modes:
+  - `/changelog` shows the latest release notes.
+  - `/changelog full` shows the full changelog.
+  - `/changelog <version>` shows a specific version.
+
+### Reliability
+- Update checks run in the background and do not block CLI startup.
+- Network/offline errors are handled silently during startup.
+- Fixed changelog section parsing on Windows CRLF files.
+
 ## 0.4.1 — Update Visibility
 
 ### New Features

package/README.md

@@ -20,8 +20,12 @@
 
 ---
 
-## What's new in 0.4.0
+## What's new in 0.4.x
 
+- Better project-mode guardrails and visible browser-mode control.
+- Startup update notice and improved `/changelog` modes.
+- `/changelog` command to view release notes inside the CLI.
+- `/update-check` command to check the latest npm version.
 - Stability and honest reporting improvements.
 - `/budget` commands to limit runaway agent loops.
 - Git Files section in Execution Summary.

package/README.ru.md

@@ -20,8 +20,12 @@
 
 ---
 
-## Что нового в 0.4.0
+## Что нового в 0.4.x
 
+- Улучшенные правила project mode и наглядное управление режимом браузера.
+- Уведомление об обновлениях при запуске и улучшенные режимы `/changelog`.
+- `/changelog` показывает список изменений прямо в CLI.
+- `/update-check` проверяет последнюю версию в npm.
 - Улучшена стабильность и честность отчётов.
 - `/budget` команды ограничивают runaway tool/API calls.
 - Execution Summary показывает Files: changed/untracked/dirty before run.

package/dist/commands/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAgBlD,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAE1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAItD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAKnD,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,cAAc,CAAA;IACtB,YAAY,EAAE,YAAY,CAAA;IAC1B,QAAQ,EAAE,WAAW,EAAE,CAAA;IACvB,WAAW,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,WAAW,EAAE,CAAC,CAAC,CAAA;IAChE,aAAa,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAA;IAC3D,YAAY,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAA;IACvC,iFAAiF;IACjF,aAAa,CAAC,EAAE,MAAM,IAAI,CAAA;IAC1B,iFAAiF;IACjF,aAAa,CAAC,EAAE,MAAM,IAAI,CAAA;IAC1B,gFAAgF;IAChF,YAAY,CAAC,EAAE,MAAM,IAAI,CAAA;IACzB,kGAAkG;IAClG,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IACzC,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,gBAAgB,GAAG,SAAS,CAAA;IAC/C,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,UAAU,GAAG,SAAS,CAAA;IACxC,6CAA6C;IAC7C,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,KAAK,IAAI,CAAA;CACrD;AA0pCD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,CAAC,GAAG,EAAE,mBAAmB,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CACvE;AAED,eAAO,MAAM,QAAQ,EAAE,YAAY,EAkClC,CAAA;AAED,eAAO,MAAM,aAAa,EAAE,MAAM,EAA8B,CAAA;AAEhE,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAEnD,CAAA;AAgBD,wBAAsB,mBAAmB,CAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC,CAapG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAgBlD,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAE1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAItD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAMnD,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,cAAc,CAAA;IACtB,YAAY,EAAE,YAAY,CAAA;IAC1B,QAAQ,EAAE,WAAW,EAAE,CAAA;IACvB,WAAW,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,WAAW,EAAE,CAAC,CAAC,CAAA;IAChE,aAAa,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAA;IAC3D,YAAY,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAA;IACvC,iFAAiF;IACjF,aAAa,CAAC,EAAE,MAAM,IAAI,CAAA;IAC1B,iFAAiF;IACjF,aAAa,CAAC,EAAE,MAAM,IAAI,CAAA;IAC1B,gFAAgF;IAChF,YAAY,CAAC,EAAE,MAAM,IAAI,CAAA;IACzB,kGAAkG;IAClG,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IACzC,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,gBAAgB,GAAG,SAAS,CAAA;IAC/C,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,UAAU,GAAG,SAAS,CAAA;IACxC,6CAA6C;IAC7C,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,KAAK,IAAI,CAAA;CACrD;AA8rCD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,CAAC,GAAG,EAAE,mBAAmB,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CACvE;AAED,eAAO,MAAM,QAAQ,EAAE,YAAY,EAkClC,CAAA;AAED,eAAO,MAAM,aAAa,EAAE,MAAM,EAA8B,CAAA;AAEhE,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAEnD,CAAA;AAgBD,wBAAsB,mBAAmB,CAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC,CAapG"}

package/dist/commands/index.js

@@ -19,6 +19,7 @@ import { getDefaultTools, getToolsForMode } from '../tools/registry.js';
 import { browserTest, getLastBrowserTestResult, browserRealTest } from '../tools/chrome.js';
 import { chromeManager } from '../tools/chrome-manager.js';
 import { AUDIT_BUDGET_PRESET } from '../tools/types.js';
+import { checkLatestVersion } from './update-checker.js';
 // ─── Helpers ─────────────────────────────────────────────────────────────────
 function generateFollowups(lastContent) {
     const suggestions = [];
@@ -76,7 +77,7 @@ const RU_DESCRIPTIONS = {
     '/last-browser-test': 'Показать последний отчёт browser-test',
     '/chrome': 'Режим Chrome: --headed|--headless|-s',
     '/budget': 'Бюджет: /budget status|off|audit|small',
-    '/changelog': 'Показать список изменений',
+    '/changelog': 'Показать изменения: /changelog [full|version]',
     '/update-check': 'Проверить новую версию',
 };
 function getDescription(name) {
@@ -793,6 +794,7 @@ async function cmdTools(ctx) {
 }
 async function cmdBrowserTest(ctx, input) {
     // Parse flags: /browser-test --headed or /browser-test --headless
+    // Default uses the configured chromeHeadless mode
     const parts = input.trim().split(/\s+/);
     const flag = parts.length > 1 ? parts[1].toLowerCase() : '';
     let headless;
@@ -803,7 +805,7 @@ async function cmdBrowserTest(ctx, input) {
         headless = true;
     }
     else {
-        headless = false; // default: headed (видимое окно)
+        headless = ctx.config.chromeHeadless ?? false; // default from config
     }
     ctx.setStatusText('Запуск browser test...');
     // Сохраняем текущий режим Chrome, чтобы восстановить после теста
@@ -835,12 +837,14 @@ async function cmdBrowserRealTest(ctx, input) {
     const parts = input.trim().split(/\s+/).slice(1);
     const saveReport = parts.includes('--save-report');
     const headless = parts.includes('--headless');
+    const headed = parts.includes('--headed');
+    const effectiveHeadless = headed ? false : headless ? true : (ctx.config.chromeHeadless ?? false);
     const siteArgs = parts.filter(p => !p.startsWith('--'));
     const sites = siteArgs.length > 0 ? siteArgs : undefined;
     ctx.setStatusText('Real site smoke-test...');
     const prevState = chromeManager.getState();
     try {
-        const report = await browserRealTest({ sites, headless });
+        const report = await browserRealTest({ sites, headless: effectiveHeadless });
         if (saveReport) {
             const { writeFile } = await import('node:fs/promises');
             await writeFile('BROWSER_REAL_TEST_REPORT.md', report, 'utf8');
@@ -865,13 +869,18 @@ async function cmdBrowserRealTest(ctx, input) {
 async function cmdChrome(ctx, input) {
     const parts = input.trim().split(/\s+/);
     const flag = parts.length > 1 ? parts[1].toLowerCase() : '';
-    // No flag — show status
+    // No flag — show status only
     if (!flag || flag === '--status' || flag === '-s') {
         const state = chromeManager.getState();
-        const modeStr = state.connected
-            ? (state.headless ? 'headless (фоновый)' : 'headed (видимое окно)')
-            : 'не запущен';
-        ctx.addServiceNotice?.(`Chrome: ${modeStr}${state.connected ? ` | PID: ${state.managedProcessPid ?? '—'} | Порт: ${state.debugPort}` : ''}`);
+        const desiredMode = ctx.config.chromeHeadless ? 'headless' : 'headed';
+        const runningStr = state.connected
+            ? (state.headless ? 'headless' : 'headed')
+            : 'not running';
+        let notice = `Browser desired mode: ${desiredMode}\nRunning Chrome: ${runningStr}`;
+        if (state.connected) {
+            notice += ` | PID: ${state.managedProcessPid ?? '—'} | Port: ${state.debugPort}`;
+        }
+        ctx.addServiceNotice?.(notice);
         return true;
     }
     // Determine desired mode
@@ -883,21 +892,30 @@ async function cmdChrome(ctx, input) {
         desiredHeadless = false;
     }
     else {
-        ctx.addServiceNotice?.('[err] /chrome: используйте --headed, --headless или без флага для статуса');
+        ctx.addServiceNotice?.('[err] /chrome: use --headed, --headless or no flag for status');
         return true;
     }
-    try {
-        await chromeManager.ensureMode(desiredHeadless);
-        const state = chromeManager.getState();
-        const modeStr = state.headless ? 'headless (фоновый)' : 'headed (видимое окно)';
-        // Save to config
-        ctx.config.chromeHeadless = state.headless;
-        saveConfig({ chromeHeadless: state.headless }).catch(() => { });
-        ctx.addServiceNotice?.(`Chrome: ${modeStr} | PID: ${state.managedProcessPid ?? '—'} | Порт: ${state.debugPort}`);
-    }
-    catch (err) {
-        ctx.addServiceNotice?.(`[err] Chrome: ${String(err)}`);
-    }
+    // Capture runtime state BEFORE changing the desired mode
+    const stateBefore = chromeManager.getState();
+    const wasRunning = stateBefore.connected;
+    const actualRunningMode = wasRunning ? (stateBefore.headless ? 'headless' : 'headed') : null;
+    // Set the mode WITHOUT launching the browser
+    chromeManager.setHeadlessMode(desiredHeadless);
+    // Save to config
+    ctx.config.chromeHeadless = desiredHeadless;
+    saveConfig({ chromeHeadless: desiredHeadless }).catch(() => { });
+    // Build status message
+    const desiredModeStr = desiredHeadless ? 'headless' : 'headed';
+    const runningStr = wasRunning ? actualRunningMode : 'not running';
+    let notice = `Browser desired mode: ${desiredModeStr}\nRunning Chrome: ${runningStr}`;
+    if (wasRunning) {
+        notice += ` | PID: ${stateBefore.managedProcessPid ?? '—'} | Port: ${stateBefore.debugPort}`;
+    }
+    // Warn if Chrome is running in a different mode
+    if (wasRunning && stateBefore.headless !== desiredHeadless) {
+        notice += `\n\n⚠️ Chrome is currently running in ${actualRunningMode} mode.\nNew mode will be used on next browser start.`;
+    }
+    ctx.addServiceNotice?.(notice);
     return true;
 }
 async function cmdLastBrowserTest(ctx) {
@@ -1015,32 +1033,83 @@ async function cmdBudget(ctx, input) {
     return true;
 }
 // ─── Changelog and Update Check ──────────────────────────────────────────────
-function semverCompare(a, b) {
-    const pa = a.split('.').map(Number);
-    const pb = b.split('.').map(Number);
-    for (let i = 0; i < 3; i++) {
-        if ((pa[i] ?? 0) > (pb[i] ?? 0))
-            return 1;
-        if ((pa[i] ?? 0) < (pb[i] ?? 0))
-            return -1;
-    }
-    return 0;
+function parseChangelogSections(content) {
+    const sections = [];
+    const lines = content.split(/\r?\n/);
+    let currentVersion = '';
+    let currentLines = [];
+    for (const line of lines) {
+        const match = line.match(/^##\s+(\d+\.\d+\.\d+)/);
+        if (match) {
+            if (currentVersion) {
+                sections.push({ version: currentVersion, content: currentLines.join('\n') });
+            }
+            currentVersion = match[1];
+            currentLines = [line];
+        }
+        else if (currentVersion) {
+            currentLines.push(line);
+        }
+    }
+    // Push last section
+    if (currentVersion) {
+        sections.push({ version: currentVersion, content: currentLines.join('\n') });
+    }
+    return sections;
 }
-async function cmdChangelog(ctx) {
+async function cmdChangelog(ctx, input) {
     const { readFileSync } = await import('node:fs');
     const { resolve, dirname } = await import('node:path');
     const { fileURLToPath } = await import('node:url');
     const __filename = fileURLToPath(import.meta.url);
     const __dirname = dirname(__filename);
     const changelogPath = resolve(__dirname, '../../CHANGELOG.md');
+    const arg = input.slice('/changelog'.length).trim();
     try {
         const content = readFileSync(changelogPath, 'utf-8');
-        // Show up to 4000 chars to avoid overwhelming the chat
-        const truncated = content.length > 4000 ? content.slice(0, 3997) + '...' : content;
-        ctx.setMessages(prev => [...prev, {
-                role: 'assistant',
-                content: truncated,
-            }]);
+        // full mode — show entire file with 4000 char limit (current behavior)
+        if (arg === 'full') {
+            const truncated = content.length > 4000 ? content.slice(0, 3997) + '...' : content;
+            ctx.setMessages(prev => [...prev, {
+                    role: 'assistant',
+                    content: truncated,
+                }]);
+            return true;
+        }
+        // Parse sections
+        const sections = parseChangelogSections(content);
+        // No arg — show only the latest release
+        if (!arg) {
+            if (sections.length === 0) {
+                // fallback: no sections found, show whole file
+                const truncated = content.length > 4000 ? content.slice(0, 3997) + '...' : content;
+                ctx.setMessages(prev => [...prev, {
+                        role: 'assistant',
+                        content: truncated,
+                    }]);
+                return true;
+            }
+            const latest = sections[0].content;
+            ctx.setMessages(prev => [...prev, {
+                    role: 'assistant',
+                    content: latest.length > 4000 ? latest.slice(0, 3997) + '...' : latest,
+                }]);
+            return true;
+        }
+        // Try to find specific version
+        const section = sections.find(s => s.version === arg);
+        if (section) {
+            ctx.setMessages(prev => [...prev, {
+                    role: 'assistant',
+                    content: section.content.length > 4000 ? section.content.slice(0, 3997) + '...' : section.content,
+                }]);
+        }
+        else {
+            ctx.setMessages(prev => [...prev, {
+                    role: 'assistant',
+                    content: `Changelog version not found: ${arg}`,
+                }]);
+        }
     }
     catch {
         ctx.setMessages(prev => [...prev, {
@@ -1051,79 +1120,36 @@ async function cmdChangelog(ctx) {
     return true;
 }
 async function cmdUpdateCheck(ctx) {
-    const { readFileSync } = await import('node:fs');
-    const { resolve, dirname } = await import('node:path');
-    const { fileURLToPath } = await import('node:url');
-    const { get } = await import('node:https');
-    // Get current version from package.json
-    const __filename = fileURLToPath(import.meta.url);
-    const __dirname = dirname(__filename);
-    const pkgPath = resolve(__dirname, '../../package.json');
-    let currentVersion;
-    try {
-        const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
-        currentVersion = pkg.version;
-    }
-    catch {
+    const result = await checkLatestVersion();
+    if (!result) {
         ctx.setMessages(prev => [...prev, {
                 role: 'assistant',
-                content: 'Could not read package version. Check your installation.',
+                content: 'Could not check for updates. Try again later.',
             }]);
         return true;
     }
-    // Check npm registry for latest version
-    try {
-        const latest = await new Promise((resolve, reject) => {
-            const url = 'https://registry.npmjs.org/@serjm%2Fdeepseek-code/latest';
-            const req = get(url, { timeout: 10000 }, (res) => {
-                let data = '';
-                res.on('data', chunk => { data += chunk; });
-                res.on('end', () => {
-                    try {
-                        const json = JSON.parse(data);
-                        resolve(json.version);
-                    }
-                    catch {
-                        reject(new Error('Invalid response from registry'));
-                    }
-                });
-            });
-            req.on('error', reject);
-            req.on('timeout', () => {
-                req.destroy();
-                reject(new Error('Request timed out'));
-            });
-        });
-        const cmp = semverCompare(latest, currentVersion);
-        if (cmp > 0) {
-            ctx.setMessages(prev => [...prev, {
-                    role: 'assistant',
-                    content: [
-                        '## Update available',
-                        '',
-                        `**Current:** ${currentVersion}`,
-                        `**Latest:** ${latest}`,
-                        '',
-                        'Run:',
-                        '```',
-                        'npm install -g @serjm/deepseek-code@latest',
-                        '```',
-                        '',
-                        'Run `/changelog` to see what\'s new.',
-                    ].join('\n'),
-                }]);
-        }
-        else {
-            ctx.setMessages(prev => [...prev, {
-                    role: 'assistant',
-                    content: `You are up to date: **${currentVersion}**`,
-                }]);
-        }
+    if (result.hasUpdate) {
+        ctx.setMessages(prev => [...prev, {
+                role: 'assistant',
+                content: [
+                    '## Update available',
+                    '',
+                    `**Current:** ${result.current}`,
+                    `**Latest:** ${result.latest}`,
+                    '',
+                    'Run:',
+                    '```',
+                    'npm install -g @serjm/deepseek-code@latest',
+                    '```',
+                    '',
+                    'Run `/changelog` to see what\'s new.',
+                ].join('\n'),
+            }]);
     }
-    catch {
+    else {
         ctx.setMessages(prev => [...prev, {
                 role: 'assistant',
-                content: 'Could not check for updates. Try again later.',
+                content: `You are up to date: **${result.current}**`,
             }]);
     }
     return true;
@@ -1160,7 +1186,7 @@ export const COMMANDS = [
     { name: '/last-browser-test', description: 'Show last browser test report', handler: cmdLastBrowserTest },
     { name: '/chrome', description: 'Chrome mode: --headed|--headless|-s', handler: cmdChrome },
     { name: '/budget', description: 'Budget: /budget status|off|audit|small', handler: cmdBudget },
-    { name: '/changelog', description: 'Show changelog', handler: cmdChangelog },
+    { name: '/changelog', description: 'Show changelog: /changelog [full|version]', handler: cmdChangelog },
     { name: '/update-check', description: 'Check latest npm version', handler: cmdUpdateCheck },
 ];
 export const COMMAND_NAMES = COMMANDS.map(c => c.name);