π OpenHands: AI-Driven Development
feat: add daily-rotating file logger for dev scripts (closes #815) (#1181)
Tim O'Farrell90754e2571fa
diff --git a/package-lock.json b/package-lock.jsonindex b288e50f3a..c5b7d29474 100644--- a/package-lock.json+++ b/package-lock.json@@ -101,7 +101,9 @@"tailwindcss": "4.2.4","typescript": "6.0.3","vite-plugin-svgr": "5.2.0",- "vitest": "4.1.5"+ "vitest": "4.1.5",+ "winston": "^3.19.0",+ "winston-daily-rotate-file": "^5.0.0"},"engines": {"node": ">=22.12.0"@@ -727,6 +729,16 @@"specificity": "bin/cli.js"}},+ "node_modules/@colors/colors": {+ "version": "1.6.0",+ "resolved": "https://registry.npmjs.org/@colors/colors/-/colors-1.6.0.tgz",+ "integrity": "sha512-Ir+AOibqzrIsL6ajt3Rz3LskB7OiMVHqltZmspbW/TJuTVuyOMirVqAkjfY6JISiLHgyNqicAC8AyHHGzNd/dA==",+ "dev": true,+ "license": "MIT",+ "engines": {+ "node": ">=0.1.90"+ }+ },"node_modules/@csstools/color-helpers": {"version": "6.0.2","resolved": "https://registry.npmjs.org/@csstools/color-helpers/-/color-helpers-6.0.2.tgz",@@ -867,6 +879,18 @@"node": ">=20.19.0"}},+ "node_modules/@dabh/diagnostics": {+ "version": "2.0.8",+ "resolved": "https://registry.npmjs.org/@dabh/diagnostics/-/diagnostics-2.0.8.tgz",+ "integrity": "sha512-R4MSXTVnuMzGD7bzHdW2ZhhdPC/igELENcq5IjEverBvq5hn1SXCWcsi6eSsdWP0/Ur+SItRRjAktmdoX/8R/Q==",+ "dev": true,+ "license": "MIT",+ "dependencies": {+ "@so-ric/colorspace": "^1.1.6",+ "enabled": "2.0.x",+ "kuler": "^2.0.0"+ }+ },"node_modules/@emnapi/core": {"version": "1.10.0","resolved": "https://registry.npmjs.org/@emnapi/core/-/core-1.10.0.tgz",@@ -6196,6 +6220,67 @@"win32"]},+ "node_modules/@so-ric/colorspace": {+ "version": "1.1.6",+ "resolved": "https://registry.npmjs.org/@so-ric/colorspace/-/colorspace-1.1.6.tgz",+ "integrity": "sha512-/KiKkpHNOBgkFJwu9sh48LkHSMYGyuTcSFK/qMBdnOAlrRJzRSXAOFB5qwzaVQuDl8wAvHVMkaASQDReTahxuw==",+ "dev": true,+ "license": "MIT",+ "dependencies": {+ "color": "^5.0.2",+ "text-hex": "1.0.x"+ }+ },+ "node_modules/@so-ric/colorspace/node_modules/color": {+ "version": "5.0.3",+ "resolved": "https://registry.npmjs.org/color/-/color-5.0.3.tgz",+ "integrity": "sha512-ezmVcLR3xAVp8kYOm4GS45ZLLgIE6SPAFoduLr6hTDajwb3KZ2F46gulK3XpcwRFb5KKGCSezCBAY4Dw4HsyXA==",+ "dev": true,+ "license": "MIT",+ "dependencies": {+ "color-convert": "^3.1.3",+ "color-string": "^2.1.3"+ },+ "engines": {+ "node": ">=18"+ }+ },+ "node_modules/@so-ric/colorspace/node_modules/color-convert": {+ "version": "3.1.3",+ "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-3.1.3.tgz",+ "integrity": "sha512-fasDH2ont2GqF5HpyO4w0+BcewlhHEZOFn9c1ckZdHpJ56Qb7MHhH/IcJZbBGgvdtwdwNbLvxiBEdg336iA9Sg==",+ "dev": true,+ "license": "MIT",+ "dependencies": {+ "color-name": "^2.0.0"+ },+ "engines": {+ "node": ">=14.6"+ }+ },+ "node_modules/@so-ric/colorspace/node_modules/color-name": {+ "version": "2.1.0",+ "resolved": "https://registry.npmjs.org/color-name/-/color-name-2.1.0.tgz",+ "integrity": "sha512-1bPaDNFm0axzE4MEAzKPuqKWeRaT43U/hyxKPBdqTfmPF+d6n7FSoTFxLVULUJOmiLp01KjhIPPH+HrXZJN4Rg==",+ "dev": true,+ "license": "MIT",+ "engines": {+ "node": ">=12.20"+ }+ },+ "node_modules/@so-ric/colorspace/node_modules/color-string": {+ "version": "2.1.4",+ "resolved": "https://registry.npmjs.org/color-string/-/color-string-2.1.4.tgz",+ "integrity": "sha512-Bb6Cq8oq0IjDOe8wJmi4JeNn763Xs9cfrBcaylK1tPypWzyoy2G3l90v9k64kjphl/ZJjPIShFztenRomi8WTg==",+ "dev": true,+ "license": "MIT",+ "dependencies": {+ "color-name": "^2.0.0"+ },+ "engines": {+ "node": ">=18"+ }+ },"node_modules/@socket.io/component-emitter": {"version": "3.1.2","resolved": "https://registry.npmjs.org/@socket.io/component-emitter/-/component-emitter-3.1.2.tgz",@@ -7098,6 +7183,13 @@"dev": true,"license": "MIT"},+ "node_modules/@types/triple-beam": {+ "version": "1.3.5",+ "resolved": "https://registry.npmjs.org/@types/triple-beam/-/triple-beam-1.3.5.tgz",+ "integrity": "sha512-6WaYesThRMCl19iryMYP7/x2OVgCtbIVflDGFpWnb9irXI3UjYE4AzmYuiUKY1AJstGijoY+MgUszMgRxIYTYw==",+ "dev": true,+ "license": "MIT"+ },"node_modules/@types/trusted-types": {"version": "2.0.7","resolved": "https://registry.npmjs.org/@types/trusted-types/-/trusted-types-2.0.7.tgz",@@ -8445,6 +8537,13 @@"dev": true,"license": "MIT"},+ "node_modules/async": {+ "version": "3.2.6",+ "resolved": "https://registry.npmjs.org/async/-/async-3.2.6.tgz",+ "integrity": "sha512-htCUDlxyyCLMgaM3xXg0C0LW2xqfuQ6p05pCEIsXuyQ+a1koYKTuBMzRNwmybfLgvJDMd0r1LTn4+E0Ti6C2AA==",+ "dev": true,+ "license": "MIT"+ },"node_modules/async-function": {"version": "1.0.0","resolved": "https://registry.npmjs.org/async-function/-/async-function-1.0.0.tgz",@@ -9705,6 +9804,13 @@"dev": true,"license": "MIT"},+ "node_modules/enabled": {+ "version": "2.0.0",+ "resolved": "https://registry.npmjs.org/enabled/-/enabled-2.0.0.tgz",+ "integrity": "sha512-AKrN98kuwOzMIdAizXGI86UFBoo26CL21UM763y1h/GMSJ4/OHU9k2YlsmBpyScFo/wbLzWQJBMCW4+IO3/+OQ==",+ "dev": true,+ "license": "MIT"+ },"node_modules/encodeurl": {"version": "2.0.0","resolved": "https://registry.npmjs.org/encodeurl/-/encodeurl-2.0.0.tgz",@@ -10856,6 +10962,13 @@}}},+ "node_modules/fecha": {+ "version": "4.2.3",+ "resolved": "https://registry.npmjs.org/fecha/-/fecha-4.2.3.tgz",+ "integrity": "sha512-OP2IUU6HeYKJi3i0z4A19kHMQoLVs4Hc+DPqqxI2h/DPZHTm/vjsfC6P0b4jCMy14XizLBqvndQ+UilD7707Jw==",+ "dev": true,+ "license": "MIT"+ },"node_modules/fflate": {"version": "0.4.8","resolved": "https://registry.npmjs.org/fflate/-/fflate-0.4.8.tgz",@@ -10875,6 +10988,16 @@"node": ">=16.0.0"}},+ "node_modules/file-stream-rotator": {+ "version": "0.6.1",+ "resolved": "https://registry.npmjs.org/file-stream-rotator/-/file-stream-rotator-0.6.1.tgz",+ "integrity": "sha512-u+dBid4PvZw17PmDeRcNOtCP9CCK/9lRN2w+r1xIS7yOL9JFrIBKTvrYsxT4P0pGtThYTn++QS5ChHaUov3+zQ==",+ "dev": true,+ "license": "MIT",+ "dependencies": {+ "moment": "^2.29.1"+ }+ },"node_modules/fill-range": {"version": "7.1.1","resolved": "https://registry.npmjs.org/fill-range/-/fill-range-7.1.1.tgz",@@ -10959,6 +11082,13 @@"dev": true,"license": "ISC"},+ "node_modules/fn.name": {+ "version": "1.1.0",+ "resolved": "https://registry.npmjs.org/fn.name/-/fn.name-1.1.0.tgz",+ "integrity": "sha512-GRnmB5gPyJpAhTQdSZTSp9uaPSvl09KoYcMQtsB9rQoOmzs9dH6ffeccH+Z+cv6P68Hu5bC6JjRh4Ah/mHSNRw==",+ "dev": true,+ "license": "MIT"+ },"node_modules/follow-redirects": {"version": "1.16.0","resolved": "https://registry.npmjs.org/follow-redirects/-/follow-redirects-1.16.0.tgz",@@ -12274,6 +12404,19 @@"url": "https://github.com/sponsors/ljharb"}},+ "node_modules/is-stream": {+ "version": "2.0.1",+ "resolved": "https://registry.npmjs.org/is-stream/-/is-stream-2.0.1.tgz",+ "integrity": "sha512-hFoiJiTl63nn+kstHGBtewWSKnQLpyb155KHheA1l39uvtO9nWIop1p3udqPcUd/xbF1VLMO4n7OI6p7RbngDg==",+ "dev": true,+ "license": "MIT",+ "engines": {+ "node": ">=8"+ },+ "funding": {+ "url": "https://github.com/sponsors/sindresorhus"+ }+ },"node_modules/is-string": {"version": "1.1.1","resolved": "https://registry.npmjs.org/is-string/-/is-string-1.1.1.tgz",@@ -12630,6 +12773,13 @@"node": ">=6"}},+ "node_modules/kuler": {+ "version": "2.0.0",+ "resolved": "https://registry.npmjs.org/kuler/-/kuler-2.0.0.tgz",+ "integrity": "sha512-Xq9nH7KlWZmXAtodXDDRE7vs6DU1gTU8zYDHDiWLSip45Egwq3plLHzPn27NgvzL2r1LMPC1vdqh98sQxtqj4A==",+ "dev": true,+ "license": "MIT"+ },"node_modules/language-subtag-registry": {"version": "0.3.23","resolved": "https://registry.npmjs.org/language-subtag-registry/-/language-subtag-registry-0.3.23.tgz",@@ -13057,6 +13207,24 @@"url": "https://github.com/chalk/slice-ansi?sponsor=1"}},+ "node_modules/logform": {+ "version": "2.7.0",+ "resolved": "https://registry.npmjs.org/logform/-/logform-2.7.0.tgz",+ "integrity": "sha512-TFYA4jnP7PVbmlBIfhlSe+WKxs9dklXMTEGcBCIvLhE/Tn3H6Gk1norupVW7m5Cnd4bLcr08AytbyV/xj7f/kQ==",+ "dev": true,+ "license": "MIT",+ "dependencies": {+ "@colors/colors": "1.6.0",+ "@types/triple-beam": "^1.3.2",+ "fecha": "^4.2.0",+ "ms": "^2.1.1",+ "safe-stable-stringify": "^2.3.1",+ "triple-beam": "^1.3.0"+ },+ "engines": {+ "node": ">= 12.0.0"+ }+ },"node_modules/long": {"version": "5.3.2","resolved": "https://registry.npmjs.org/long/-/long-5.3.2.tgz",@@ -14227,6 +14395,16 @@"node": ">=10"}},+ "node_modules/moment": {+ "version": "2.30.1",+ "resolved": "https://registry.npmjs.org/moment/-/moment-2.30.1.tgz",+ "integrity": "sha512-uEmtNhbDOrWPFS+hdjFCBfy9f2YoyzRpwcl+DqpC6taX21FzsTLQVbMV/W7PzNSX6x/bhC1zA3c2UQ5NzH6how==",+ "dev": true,+ "license": "MIT",+ "engines": {+ "node": "*"+ }+ },"node_modules/monaco-editor": {"version": "0.55.1","resolved": "https://registry.npmjs.org/monaco-editor/-/monaco-editor-0.55.1.tgz",@@ -14533,6 +14711,16 @@"node": ">=0.10.0"}},+ "node_modules/object-hash": {+ "version": "3.0.0",+ "resolved": "https://registry.npmjs.org/object-hash/-/object-hash-3.0.0.tgz",+ "integrity": "sha512-RSn9F68PjH9HqtltsSnqYC1XXoWe9Bju5+213R98cNGttag9q9yAOTzdbsqvIa7aNm5WffBZFpWYr2aWrklWAw==",+ "dev": true,+ "license": "MIT",+ "engines": {+ "node": ">= 6"+ }+ },"node_modules/object-inspect": {"version": "1.13.4","resolved": "https://registry.npmjs.org/object-inspect/-/object-inspect-1.13.4.tgz",@@ -14662,6 +14850,16 @@"node": ">= 0.8"}},+ "node_modules/one-time": {+ "version": "1.0.0",+ "resolved": "https://registry.npmjs.org/one-time/-/one-time-1.0.0.tgz",+ "integrity": "sha512-5DXOiRKwuSEcQ/l0kGCF6Q3jcADFv5tSmRaJck/OqkVFcOzutB134KRSfF0xDrL39MNnqxbHBbUUcjZIhTgb2g==",+ "dev": true,+ "license": "MIT",+ "dependencies": {+ "fn.name": "1.x.x"+ }+ },"node_modules/onetime": {"version": "7.0.0","resolved": "https://registry.npmjs.org/onetime/-/onetime-7.0.0.tgz",@@ -15648,6 +15846,21 @@"react-dom": ">=16.6.0"}},+ "node_modules/readable-stream": {+ "version": "3.6.2",+ "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-3.6.2.tgz",+ "integrity": "sha512-9u/sniCrY3D5WdsERHzHE4G2YCXqoG5FTHUiCC4SIbr6XcLZBY05ya9EKjYek9O5xOAwjGq+1JdGBAS7Q9ScoA==",+ "dev": true,+ "license": "MIT",+ "dependencies": {+ "inherits": "^2.0.3",+ "string_decoder": "^1.1.1",+ "util-deprecate": "^1.0.1"+ },+ "engines": {+ "node": ">= 6"+ }+ },"node_modules/readdirp": {"version": "4.1.2","resolved": "https://registry.npmjs.org/readdirp/-/readdirp-4.1.2.tgz",@@ -16158,6 +16371,16 @@"url": "https://github.com/sponsors/ljharb"}},+ "node_modules/safe-stable-stringify": {+ "version": "2.5.0",+ "resolved": "https://registry.npmjs.org/safe-stable-stringify/-/safe-stable-stringify-2.5.0.tgz",+ "integrity": "sha512-b3rppTKm9T+PsVCBEOUR46GWI7fdOs00VKZ1+9c1EWDaDMvjQc6tUwuFyIprgGgTcWoVHSKrU8H31ZHA2e0RHA==",+ "dev": true,+ "license": "MIT",+ "engines": {+ "node": ">=10"+ }+ },"node_modules/safer-buffer": {"version": "2.1.2","resolved": "https://registry.npmjs.org/safer-buffer/-/safer-buffer-2.1.2.tgz",@@ -16619,6 +16842,16 @@"node": ">=12.0.0"}},+ "node_modules/stack-trace": {+ "version": "0.0.10",+ "resolved": "https://registry.npmjs.org/stack-trace/-/stack-trace-0.0.10.tgz",+ "integrity": "sha512-KGzahc7puUKkzyMt+IqAep+TVNbKP+k2Lmwhub39m1AsTSkaDutx56aDCo+HLDzf/D26BIHTJWNiTG1KAJiQCg==",+ "dev": true,+ "license": "MIT",+ "engines": {+ "node": "*"+ }+ },"node_modules/stackback": {"version": "0.0.2","resolved": "https://registry.npmjs.org/stackback/-/stackback-0.0.2.tgz",@@ -16669,6 +16902,16 @@"dev": true,"license": "MIT"},+ "node_modules/string_decoder": {+ "version": "1.3.0",+ "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.3.0.tgz",+ "integrity": "sha512-hkRX8U1WjJFd8LsDJ2yQ/wWWxaopEsABU1XfkM8A+j0+85JAGppt16cr1Whg6KIbb4okU6Mql6BOj+uup/wKeA==",+ "dev": true,+ "license": "MIT",+ "dependencies": {+ "safe-buffer": "~5.2.0"+ }+ },"node_modules/string-argv": {"version": "0.3.2","resolved": "https://registry.npmjs.org/string-argv/-/string-argv-0.3.2.tgz",@@ -17028,6 +17271,13 @@"url": "https://opencollective.com/webpack"}},+ "node_modules/text-hex": {+ "version": "1.0.0",+ "resolved": "https://registry.npmjs.org/text-hex/-/text-hex-1.0.0.tgz",+ "integrity": "sha512-uuVGNWzgJ4yhRaNSiubPY7OjISw4sw4E5Uv0wbjp+OzcbmVU/rsT8ujgcXJhn9ypzsgr5vlzpPqP+MBBKcGvbg==",+ "dev": true,+ "license": "MIT"+ },"node_modules/tinybench": {"version": "2.9.0","resolved": "https://registry.npmjs.org/tinybench/-/tinybench-2.9.0.tgz",@@ -17167,6 +17417,16 @@"url": "https://github.com/sponsors/wooorm"}},+ "node_modules/triple-beam": {+ "version": "1.4.1",+ "resolved": "https://registry.npmjs.org/triple-beam/-/triple-beam-1.4.1.tgz",+ "integrity": "sha512-aZbgViZrg1QNcG+LULa7nhZpJTZSLm/mXnHXnbAbjmN5aSa0y7V+wvv6+4WaBtpISJzThKy+PIPxc1Nq1EJ9mg==",+ "dev": true,+ "license": "MIT",+ "engines": {+ "node": ">= 14.0.0"+ }+ },"node_modules/trough": {"version": "2.2.0","resolved": "https://registry.npmjs.org/trough/-/trough-2.2.0.tgz",@@ -18239,6 +18499,63 @@"node": ">=8"}},+ "node_modules/winston": {+ "version": "3.19.0",+ "resolved": "https://registry.npmjs.org/winston/-/winston-3.19.0.tgz",+ "integrity": "sha512-LZNJgPzfKR+/J3cHkxcpHKpKKvGfDZVPS4hfJCc4cCG0CgYzvlD6yE/S3CIL/Yt91ak327YCpiF/0MyeZHEHKA==",+ "dev": true,+ "license": "MIT",+ "dependencies": {+ "@colors/colors": "^1.6.0",+ "@dabh/diagnostics": "^2.0.8",+ "async": "^3.2.3",+ "is-stream": "^2.0.0",+ "logform": "^2.7.0",+ "one-time": "^1.0.0",+ "readable-stream": "^3.4.0",+ "safe-stable-stringify": "^2.3.1",+ "stack-trace": "0.0.x",+ "triple-beam": "^1.3.0",+ "winston-transport": "^4.9.0"+ },+ "engines": {+ "node": ">= 12.0.0"+ }+ },+ "node_modules/winston-daily-rotate-file": {+ "version": "5.0.0",+ "resolved": "https://registry.npmjs.org/winston-daily-rotate-file/-/winston-daily-rotate-file-5.0.0.tgz",+ "integrity": "sha512-JDjiXXkM5qvwY06733vf09I2wnMXpZEhxEVOSPenZMii+g7pcDcTBt2MRugnoi8BwVSuCT2jfRXBUy+n1Zz/Yw==",+ "dev": true,+ "license": "MIT",+ "dependencies": {+ "file-stream-rotator": "^0.6.1",+ "object-hash": "^3.0.0",+ "triple-beam": "^1.4.1",+ "winston-transport": "^4.7.0"+ },+ "engines": {+ "node": ">=8"+ },+ "peerDependencies": {+ "winston": "^3"+ }+ },+ "node_modules/winston-transport": {+ "version": "4.9.0",+ "resolved": "https://registry.npmjs.org/winston-transport/-/winston-transport-4.9.0.tgz",+ "integrity": "sha512-8drMJ4rkgaPo1Me4zD/3WLfI/zPdA9o2IipKODunnGDcuqbHwjsbB79ylv04LCGGzU0xQ6vTznOMpQGaLhhm6A==",+ "dev": true,+ "license": "MIT",+ "dependencies": {+ "logform": "^2.7.0",+ "readable-stream": "^3.6.2",+ "triple-beam": "^1.3.0"+ },+ "engines": {+ "node": ">= 12.0.0"+ }+ },"node_modules/word-wrap": {"version": "1.2.5","resolved": "https://registry.npmjs.org/word-wrap/-/word-wrap-1.2.5.tgz",diff --git a/package.json b/package.jsonindex 390c73231d..f57b673767 100644--- a/package.json+++ b/package.json@@ -153,7 +153,9 @@"tailwindcss": "4.2.4","typescript": "6.0.3","vite-plugin-svgr": "5.2.0",- "vitest": "4.1.5"+ "vitest": "4.1.5",+ "winston": "^3.19.0",+ "winston-daily-rotate-file": "^5.0.0"},"packageManager": "[email protected]","volta": {diff --git a/scripts/dev-safe.mjs b/scripts/dev-safe.mjsindex e93aaa5e34..e809d7e7b0 100644--- a/scripts/dev-safe.mjs+++ b/scripts/dev-safe.mjs@@ -25,6 +25,7 @@ import {// Docker entrypoint can run it as a CLI. Re-exported below for back-compat// (dev-with-automation.mjs and tests still import it from here).import { buildRuntimeServicesInfo } from "./runtime-services-info.mjs";+import { fileLog, stripAnsi } from "./logger.mjs";// ββ Centralized config (single source of truth for versions, ports, etc.) βββconst __dev_safe_dirname = path.dirname(fileURLToPath(import.meta.url));@@ -834,13 +835,16 @@ function spawnProcess(command, args, options = {}) {child.once("error", (error) => {if (isEnoentError(error) && command === "uvx") {- console.error(formatMissingUvxGuidance(options?.cwd));+ const msg = formatMissingUvxGuidance(options?.cwd);+ console.error(msg);+ fileLog("error", stripAnsi(msg));} else if (isEnoentError(error)) {- console.error(- `Failed to start ${command}. Make sure it is installed and on your PATH.`,- );+ const msg = `Failed to start ${command}. Make sure it is installed and on your PATH.`;+ console.error(msg);+ fileLog("error", msg);} else {console.error(`Failed to start ${command}:`, error);+ fileLog("error", `Failed to start ${command}: ${error.message}`);}});@@ -849,9 +853,12 @@ function spawnProcess(command, args, options = {}) {async function main() {console.log("Starting isolated agent-server + frontend dev stack...");+ fileLog("info", "Starting isolated agent-server + frontend dev stack...");validateFrontendDependencies();console.log("Frontend dependencies found.");+ fileLog("info", "Frontend dependencies found.");console.log("Allocating ports...");+ fileLog("info", "Allocating ports...");// Use async config builder with dynamic port allocationconst config = await buildSafeDevConfigAsync();@@ -890,6 +897,16 @@ async function main() {console.log(`- secret key: ${secretKeySource}`);console.log(`- session API key: ${sessionKeySource}`);console.log("");+ fileLog(+ "info",+ [+ "Agent-server stack config:",+ ` agent-server: ${agentServerCmd.source}`,+ ` backend: ${config.backendBaseUrl}`,+ ` working dir: ${config.workingDir}`,+ ` state dir: ${config.stateDir}`,+ ].join("\n"),+ );const backend = spawnProcess(agentServerCmd.command,@@ -990,7 +1007,9 @@ async function main() {backend.once("exit", (code) => {if (!shuttingDown) {- console.error(`agent-server exited unexpectedly with code ${code ?? 0}`);+ const msg = `agent-server exited unexpectedly with code ${code ?? 0}`;+ console.error(msg);+ fileLog("error", msg);shutdown();process.exitCode = code ?? 1;}@@ -1077,7 +1096,12 @@ if (import.meta.url === pathToFileURL(process.argv[1]).href) {main().catch((error) => {- console.error(error instanceof Error ? error.message : error);+ const msg = error instanceof Error ? error.message : String(error);+ console.error(msg);+ fileLog("error", `Fatal error: ${msg}`);+ if (error instanceof Error && error.stack) {+ fileLog("error", error.stack);+ }process.exit(1);});}diff --git a/scripts/dev-with-automation.mjs b/scripts/dev-with-automation.mjsindex 6393fe539c..9779e8ec87 100644--- a/scripts/dev-with-automation.mjs+++ b/scripts/dev-with-automation.mjs@@ -68,6 +68,7 @@ import {isProcessRunning,signalProcessTree,} from "./dev-process-utils.mjs";+import { fileLog, stripAnsi } from "./logger.mjs";const __dirname = dirname(fileURLToPath(import.meta.url));const projectRoot = resolve(__dirname, "..");@@ -105,18 +106,22 @@ const c = {function logService(name, message, color = c.reset) {const ts = new Date().toISOString().split("T")[1].split(".")[0];console.log(`${c.dim}${ts}${c.reset} ${color}[${name}]${c.reset} ${message}`);+ fileLog("info", `[${name}] ${stripAnsi(message)}`);}function logStep(step, message) {console.log(`${c.cyan}[${step}]${c.reset} ${message}`);+ fileLog("info", `[${step}] ${message}`);}function logSuccess(message) {console.log(`${c.green}β${c.reset} ${message}`);+ fileLog("info", `β ${message}`);}function logError(message) {console.error(`${c.red}β${c.reset} ${message}`);+ fileLog("error", `β ${stripAnsi(message)}`);}/**@@ -472,7 +477,9 @@ function checkPrerequisites({if (checkUvx) {if (!commandExists("uvx")) {- console.error(formatMissingUvxGuidance(projectRoot));+ const uvxGuidance = formatMissingUvxGuidance(projectRoot);+ console.error(uvxGuidance);+ fileLog("error", stripAnsi(uvxGuidance));process.exit(1);}logSuccess("uvx found");@@ -862,6 +869,7 @@ function shutdown() {console.log("");console.log(`${c.yellow}Shutting down...${c.reset}`);+ fileLog("info", "Shutting down...");for (const [name, proc] of processes) {logService(name, "Stopping...", c.dim);@@ -1133,6 +1141,20 @@ function printBanner(config) {console.log(`${c.dim}State directory: ${config.stateDir}${c.reset}`);console.log(`${c.dim}Press Ctrl+C to stop${c.reset}`);console.log("");++ // Write a compact plain-text summary to the log file.+ const summary = [+ `${stackName} β started`,+ ` Ingress: http://localhost:${config.ingressPort}/`,+ ...(config.launchFrontend+ ? [` Main UI: http://localhost:${config.ingressPort}/`]+ : []),+ ...(config.launchAutomation+ ? [` API Docs: http://localhost:${config.ingressPort}/api/automation/docs`]+ : []),+ ` State directory: ${config.stateDir}`,+ ];+ fileLog("info", summary.join("\n"));}async function main(options = {}) {@@ -1186,6 +1208,7 @@ async function main(options = {}) {console.log("");console.log(`${c.cyan}${c.bold}${titleWithMode}${c.reset}`);console.log("");+ fileLog("info", titleWithMode);// Setup phasecheckPrerequisites({@@ -1397,6 +1420,7 @@ if (isMainModule) {logError(`Fatal error: ${err.message}`);if (err.stack) {console.error(c.dim + err.stack + c.reset);+ fileLog("error", err.stack);}process.exit(1);});diff --git a/scripts/logger.mjs b/scripts/logger.mjsnew file mode 100644index 0000000000..9c93bdd64a--- /dev/null+++ b/scripts/logger.mjs@@ -0,0 +1,77 @@+/**+ * Shared file logger for agent-canvas dev scripts.+ *+ * Writes log output to a daily-rotating file under <project-root>/logs/+ * alongside the existing console output (which is unchanged).+ *+ * File naming: logs/agent-canvas.YYYY-MM-DD.log+ * Retention: 7 days (files older than 7 days are automatically deleted)+ */++import { mkdirSync } from "node:fs";+import { homedir } from "node:os";+import { join } from "node:path";+import process from "node:process";+import { createLogger, format } from "winston";+import DailyRotateFile from "winston-daily-rotate-file";++// Mirror the state-directory logic from dev-safe.mjs so log files live+// alongside all other agent-canvas runtime state (e.g. ~/.openhands/agent-canvas).+// The same env var (OH_CANVAS_SAFE_STATE_DIR) overrides both.+const stateDir =+ process.env.OH_CANVAS_SAFE_STATE_DIR ||+ join(homedir(), ".openhands", "agent-canvas");+const logDir = join(stateDir, "logs");++// Ensure the logs directory exists before the transport tries to open a file.+mkdirSync(logDir, { recursive: true });++// Matches any ANSI CSI escape sequence (colors, cursor movement, etc.).+const ANSI_RE = /\x1b\[[0-9;]*m/g;++/**+ * Remove ANSI escape codes so log files contain clean plain text.+ * @param {string} str+ * @returns {string}+ */+export function stripAnsi(str) {+ return typeof str === "string" ? str.replace(ANSI_RE, "") : String(str);+}++const fileTransport = new DailyRotateFile({+ dirname: logDir,+ filename: "agent-canvas.%DATE%.log",+ datePattern: "YYYY-MM-DD",+ maxFiles: "7d",+ // Audit file tracks which rotated files exist; kept alongside log files.+ auditFile: join(logDir, ".log-audit.json"),+ createSymlink: false,+});++const fileLogger = createLogger({+ level: "debug",+ format: format.combine(+ format.timestamp({ format: "YYYY-MM-DD HH:mm:ss" }),+ format.printf(+ ({ timestamp, level, message }) =>+ `${timestamp} [${level.toUpperCase().padEnd(5)}] ${message}`,+ ),+ ),+ transports: [fileTransport],+});++// Swallow any transport-level errors (e.g. disk full) so a logging failure+// never crashes the dev server.+fileLogger.on("error", () => {});+fileTransport.on("error", () => {});++/**+ * Write a message to the rotating log file.+ * ANSI escape codes are stripped automatically; console output is unaffected.+ *+ * @param {'info' | 'warn' | 'error' | 'debug'} level+ * @param {string} message+ */+export function fileLog(level, message) {+ fileLogger.log(level, stripAnsi(message));+}