@romanmatena/browsermonitor 2.0.0 → 2.1.0

package/src/init.mjs

@@ -1,26 +1,17 @@
 /**
- * browsermonitor init – first-run setup and agent file updates.
- *
- * Called by:
- *   - `browsermonitor init` subcommand (explicit)
- *   - Auto-init on first run when .browsermonitor/ does not exist
- *
- * What it does:
- *   1. Creates .browsermonitor/ directory structure
- *   2. Creates settings.json with defaults (prompts for URL if TTY)
- *   3. Updates CLAUDE.md, AGENTS.md, memory.md with Browser Monitor section
- *   4. Suggests adding .browsermonitor/ to .gitignore
+ * browsermonitor init – creates settings.json with defaults, updates agent files.
  */
 
 import fs from 'fs';
 import path from 'path';
 import { fileURLToPath } from 'url';
 import {
-  DEFAULT_SETTINGS,
   ensureDirectories,
-  getPaths,
-  saveSettings,
+  loadSettings,
+  DEFAULT_SETTINGS,
 } from './settings.mjs';
+import { C } from './utils/colors.mjs';
+import { printBulletBox } from './templates/section-heading.mjs';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 
@@ -31,132 +22,86 @@ const TEMPLATE_PATH = path.resolve(__dirname, 'agents.llm/browser-monitor-sectio
 
 /**
  * Replace existing tagged block or append template to a doc file.
- * Section is identified by BEGIN/END tags.
- * @param {string} hostDir
- * @param {string} docFilename - e.g. 'CLAUDE.md', 'AGENTS.md', 'memory.md'
- * @param {string} templateContent - full block including BEGIN and END tags
- * @returns {boolean} true if file was updated
  */
 function replaceOrAppendSection(hostDir, docFilename, templateContent) {
   const hostPath = path.join(hostDir, docFilename);
-  if (!fs.existsSync(hostPath)) return false;
+  if (!fs.existsSync(hostPath)) return null;
 
   const content = fs.readFileSync(hostPath, 'utf8');
   const trimmedTemplate = templateContent.trimEnd();
   const beginIndex = content.indexOf(BEGIN_TAG_PREFIX);
 
   let newContent;
+  let action;
   if (beginIndex === -1) {
     newContent = content.trimEnd() + '\n\n' + trimmedTemplate + '\n';
-    console.log(`[browsermonitor] Appended Browser Monitor section to ${docFilename}`);
+    action = 'appended';
   } else {
     const endTagStartIndex = content.indexOf(END_TAG_PREFIX, beginIndex);
-    if (endTagStartIndex === -1) {
-      console.error(`[browsermonitor] ${docFilename}: BEGIN tag found but no END tag; skipping`);
-      return false;
-    }
+    if (endTagStartIndex === -1) return null;
     const afterEndComment = content.indexOf('-->', endTagStartIndex) + 3;
     const lineEnd = content.indexOf('\n', afterEndComment);
     const endIndex = lineEnd === -1 ? content.length : lineEnd + 1;
     newContent = content.slice(0, beginIndex) + trimmedTemplate + '\n' + content.slice(endIndex);
-    console.log(`[browsermonitor] Replaced Browser Monitor section in ${docFilename}`);
+    action = 'replaced';
   }
 
   try {
     fs.writeFileSync(hostPath, newContent);
-    return true;
-  } catch (err) {
-    console.error(`[browsermonitor] Could not write ${docFilename}:`, err.message);
-    return false;
+    return action;
+  } catch {
+    return null;
   }
 }
 
-/**
- * Prompt user for default URL (stdin line read).
- * @param {string} defaultValue
- * @returns {Promise<string>}
- */
-function askDefaultUrl(defaultValue) {
-  return new Promise((resolve) => {
-    process.stdout.write(`  Default URL [${defaultValue}]: `);
-    process.stdin.resume();
-    process.stdin.setEncoding('utf8');
-    process.stdin.once('data', (chunk) => {
-      process.stdin.pause();
-      const trimmed = chunk.toString().trim().split('\n')[0].trim();
-      resolve(trimmed || defaultValue);
-    });
-  });
-}
-
-/**
- * Suggest adding .browsermonitor/ to .gitignore if not already present.
- * @param {string} projectRoot
- */
-function suggestGitignore(projectRoot) {
-  const gitignorePath = path.join(projectRoot, '.gitignore');
-  if (!fs.existsSync(gitignorePath)) return;
-
-  const content = fs.readFileSync(gitignorePath, 'utf8');
-  if (content.includes('.browsermonitor')) return;
-
-  console.log(`[browsermonitor] Tip: add .browsermonitor/ to your .gitignore`);
-}
-
 /**
  * Run browsermonitor initialization.
- * @param {string} projectRoot - Absolute path to the project
- * @param {Object} [options]
- * @param {boolean} [options.askForUrl=true] - Prompt for default URL
- * @param {boolean} [options.updateAgentFiles=true] - Update CLAUDE.md/AGENTS.md/memory.md
  */
-export async function runInit(projectRoot, options = {}) {
-  const { askForUrl = true, updateAgentFiles = true } = options;
+export async function runInit(projectRoot, config = {}) {
+  // Merge: explicit config > saved settings > defaults
+  const saved = loadSettings(projectRoot);
+  config = { ...DEFAULT_SETTINGS, ...saved, ...config };
+  const { updateAgentFiles = true } = config;
 
-  console.log('');
-  console.log('========================================');
-  console.log('  Browser Monitor - Setup');
-  console.log('========================================');
-  console.log('');
-  console.log(`[browsermonitor] Project: ${projectRoot}`);
-  console.log('');
-
-  // 1. Create directory structure
   ensureDirectories(projectRoot);
-  console.log('[browsermonitor] Created .browsermonitor/ directory structure');
 
-  // 2. Create settings.json if it doesn't exist
-  const { settingsFile } = getPaths(projectRoot);
-  if (!fs.existsSync(settingsFile)) {
-    let defaultUrl = DEFAULT_SETTINGS.defaultUrl;
-    if (askForUrl && process.stdin.isTTY) {
-      defaultUrl = await askDefaultUrl(defaultUrl);
+  // Update agent files (render template with settings values)
+  const agentUpdates = [];
+  if (updateAgentFiles && fs.existsSync(TEMPLATE_PATH)) {
+    let templateContent = fs.readFileSync(TEMPLATE_PATH, 'utf8');
+    templateContent = templateContent
+      .replace(/\{\{DEFAULT_URL\}\}/g, config.defaultUrl)
+      .replace(/\{\{HTTP_PORT\}\}/g, String(config.httpPort));
+    for (const docFile of ['CLAUDE.md', 'AGENTS.md', 'memory.md']) {
+      const action = replaceOrAppendSection(projectRoot, docFile, templateContent);
+      if (action) agentUpdates.push(`${action} ${C.cyan}${docFile}${C.reset}`);
     }
-    const settings = { ...DEFAULT_SETTINGS, defaultUrl };
-    saveSettings(projectRoot, settings);
-    console.log(`[browsermonitor] Created settings.json (defaultUrl: ${defaultUrl})`);
-  } else {
-    console.log('[browsermonitor] settings.json already exists, skipping');
   }
 
-  // 3. Update agent files
-  if (updateAgentFiles) {
-    if (!fs.existsSync(TEMPLATE_PATH)) {
-      console.error('[browsermonitor] Agent template not found:', TEMPLATE_PATH);
-    } else {
-      const templateContent = fs.readFileSync(TEMPLATE_PATH, 'utf8');
-      replaceOrAppendSection(projectRoot, 'CLAUDE.md', templateContent);
-      replaceOrAppendSection(projectRoot, 'AGENTS.md', templateContent);
-      replaceOrAppendSection(projectRoot, 'memory.md', templateContent);
+  // Gitignore check
+  let gitignoreHint = null;
+  const gitignorePath = path.join(projectRoot, '.gitignore');
+  if (fs.existsSync(gitignorePath)) {
+    const content = fs.readFileSync(gitignorePath, 'utf8');
+    if (!content.includes('.browsermonitor')) {
+      gitignoreHint = `${C.yellow}Tip:${C.reset} add ${C.cyan}.browsermonitor/${C.reset} to .gitignore`;
     }
   }
 
-  // 4. Suggest .gitignore
-  suggestGitignore(projectRoot);
+  // Display results
+  const lines = [
+    `${C.cyan}Project:${C.reset} ${projectRoot}`,
+    `${C.green}Created${C.reset} .browsermonitor/`,
+  ];
+  if (config.defaultUrl) {
+    lines[1] += ` → ${C.cyan}${config.defaultUrl}${C.reset}`;
+  }
+  if (agentUpdates.length > 0) {
+    lines.push(`${C.green}Agent docs:${C.reset} ${agentUpdates.join(', ')}`);
+  }
+  if (gitignoreHint) lines.push(gitignoreHint);
 
   console.log('');
-  console.log('[browsermonitor] Setup complete.');
-  console.log('  browsermonitor          - Interactive menu (o=open, j=join, q=quit)');
-  console.log('  browsermonitor --open   - Launch Chrome at default URL');
+  printBulletBox(lines);
   console.log('');
 }

package/src/intro.mjs

@@ -8,7 +8,7 @@ import { printCliCommandsTable } from './templates/cli-commands.mjs';
 
 const TITLE = 'Browser Monitor';
 const TAGLINE = 'Browser console, network & DOM capture for debugging and LLM workflows';
-const NPM_URL = 'https://www.npmjs.com/package/browsermonitor';
+const NPM_URL = 'https://www.npmjs.com/package/@romanmatena/browsermonitor';
 const GITHUB_URL = 'https://github.com/romanmatena/browsermonitor';
 
 export function printAppIntro() {

package/src/logging/LogBuffer.mjs

@@ -30,7 +30,7 @@ export class LogBuffer {
       ignorePatterns = [],
     } = options;
 
-    this.outputDir = outputDir;
+    this.outputDir = path.resolve(outputDir);
     this.lazyMode = lazyMode;
 
     if (paths) {

package/src/monitor/README.md

@@ -1,10 +1,23 @@
 # Monitor submodule
 
-Sdílené moduly pro režimy join, open a interactive.
+Sdílené moduly pro režimy join a open.
 
-- **page-monitoring.mjs** – připojení console/network listenerů na stránku (sdílené pro join i open).
+- **open-mode.mjs** – spuštění nového Chrome.
+- **join-mode.mjs** – připojení k běžícímu Chrome.
+- **page-monitoring.mjs** – připojení console/network listenerů na stránku.
 - **tab-selection.mjs** – výběr tabu (askUserToSelectPage, ensureKeypressEvents).
-- **interactive-mode.mjs** – interaktivní menu (o = open, j = join, q = quit), výběr projektového adresáře, výběr Chrome instance.
-- **index.mjs** – re-exporty pro přehled API.
 
-Veřejné API (`runJoinMode`, `runOpenMode`, `runInteractiveMode`) zůstává v `../monitor.mjs` kvůli absenci cyklických závislostí.
+## shared/
+
+Společné utility používané oběma režimy:
+
+- **user-page-filter.mjs** – filtruje interní Chrome stránky (chrome://, devtools://, extension://).
+- **monitoring-wrapper.mjs** – factory pro setupPageMonitoring s vazbou na session state.
+- **help.mjs** – periodický help reminder + full in-session help (h key).
+- **http-state-setup.mjs** – napojení sharedHttpState callbacků na mode-local state.
+- **tab-switching.mjs** – interaktivní přepínání tabů (t key).
+- **cleanup.mjs** – cleanup funkce + signal handlery (SIGINT, SIGTERM, uncaughtException).
+- **keyboard-handler.mjs** – keyboard input handler (d, c, q, k, s, p, t, h).
+- **index.mjs** – barrel re-exporty všech shared modulů.
+
+Veřejné API (`runJoinMode`, `runOpenMode`) se importuje přímo z jednotlivých souborů v `cli.mjs`.