@ywal123456/jskim 0.3.0 → 0.3.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ywal123456/jskim",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Nunjucks-based static HTML build environment with watch, serve, and live reload",
   "keywords": [
     "nunjucks",

package/scripts/commands/path-display.js

@@ -1,20 +1,6 @@
 'use strict';
 
-const path = require('node:path');
-
-/**
- * ワークスペース相対の表示用パスへ変換します。
- * @param {string} abs
- * @param {string} workspaceRoot
- * @returns {string}
- */
-function toDisplayPath(abs, workspaceRoot) {
-  const rel = path.relative(workspaceRoot, abs);
-  if (!rel || rel.startsWith('..') || path.isAbsolute(rel)) {
-    return abs.split(path.sep).join('/');
-  }
-  return rel.split(path.sep).join('/');
-}
+const { toDisplayPath } = require('../lib/to-display-path');
 
 module.exports = {
   toDisplayPath,

package/scripts/lib/create-nunjucks-env.js

@@ -87,7 +87,8 @@ function wrapSyncCallable(fn, label) {
     if (result && typeof result.then === 'function') {
       throw new Error(
         `[JSKim] 非同期${label.startsWith('filter') ? 'filter' : 'global'}は現在サポートされていません。\n` +
-          `対象: ${label}`
+          `対象: ${label}\n` +
+          `同期の function のみ登録できます。`
       );
     }
     return result;

package/scripts/lib/create-project-watcher.js

@@ -184,9 +184,9 @@ function createProjectWatcher(project, options = {}) {
           `[JSKim] プロジェクト "${project.name}" の初回ビルドに失敗しました。ウォッチャーは開始します。`
         );
       } else {
-        const representative = events[events.length - 1] || null;
         console.error(`[JSKim] 再ビルドに失敗しました`);
         console.error(`プロジェクト: ${project.name}`);
+        const representative = events[events.length - 1] || null;
         if (representative) {
           console.error(`イベント: ${representative.event}`);
           console.error(`ファイル: ${representative.file}`);
@@ -194,7 +194,12 @@ function createProjectWatcher(project, options = {}) {
         if (events.length > 1) {
           console.error(`変更数: ${events.length} ファイル`);
         }
-        console.error(`原因: ${message}`);
+        // 診断付きメッセージは重複ヘッダーを避けるためそのまま出力する
+        if (String(message).startsWith('[JSKim]')) {
+          console.error(message);
+        } else {
+          console.error(`原因: ${message}`);
+        }
         console.error(
           `[JSKim] ウォッチャーは継続中です。修正して保存すると再試行します。`
         );

package/scripts/lib/format-diagnostic.js

@@ -0,0 +1,234 @@
+'use strict';
+
+const { toDisplayPath } = require('./to-display-path');
+
+/**
+ * Error から短い原因メッセージを取り出します（stack は含めません）。
+ * @param {unknown} err
+ * @returns {string}
+ */
+function getCauseMessage(err) {
+  if (!err) {
+    return String(err);
+  }
+  if (typeof err === 'string') {
+    return err;
+  }
+  if (err && typeof err.message === 'string' && err.message.trim() !== '') {
+    return err.message;
+  }
+  return String(err);
+}
+
+/**
+ * Nunjucks が lineno / colno を提供する場合だけ位置を返します。
+ * message 本文の正規表現解析は行いません。
+ *
+ * @param {unknown} err
+ * @returns {{ line?: number, column?: number }}
+ */
+function readNunjucksLocation(err) {
+  if (!err || typeof err !== 'object') {
+    return {};
+  }
+
+  const lineno = err.lineno;
+  const colno = err.colno;
+  const result = {};
+
+  if (Number.isInteger(lineno) && lineno > 0) {
+    result.line = lineno;
+  }
+  if (Number.isInteger(colno) && colno > 0) {
+    result.column = colno;
+  }
+
+  return result;
+}
+
+/**
+ * Nunjucks レンダリング失敗の診断メッセージを組み立てます。
+ *
+ * @param {object} options
+ * @param {string} options.projectName
+ * @param {string} options.sourceFile
+ * @param {string} options.templatePath
+ * @param {string} [options.workspaceRoot]
+ * @param {unknown} options.err
+ * @returns {string}
+ */
+function formatRenderError(options) {
+  const {
+    projectName,
+    sourceFile,
+    templatePath,
+    workspaceRoot,
+    err,
+  } = options;
+
+  const sourceDisplay = toDisplayPath(sourceFile, workspaceRoot);
+  const location = readNunjucksLocation(err);
+  const cause = getCauseMessage(err);
+
+  const lines = [
+    `[JSKim] プロジェクト "${projectName}" の Nunjucks レンダリングに失敗しました。`,
+    `ソース: ${sourceDisplay}`,
+    `テンプレート: ${templatePath}`,
+  ];
+
+  if (location.line != null) {
+    lines.push(`行: ${location.line}`);
+  }
+  if (location.column != null) {
+    lines.push(`列: ${location.column}`);
+  }
+
+  lines.push(`原因: ${cause}`);
+  lines.push('テンプレート構文または参照先（extends / include）を確認してください。');
+
+  return lines.join('\n');
+}
+
+/**
+ * 出力パス衝突の診断メッセージを組み立てます。
+ *
+ * @param {object} options
+ * @param {string} options.projectName
+ * @param {string} options.outputFile
+ * @param {string} options.sourceFileA
+ * @param {string} options.sourceFileB
+ * @param {number} [options.ruleIndexA]
+ * @param {number} [options.ruleIndexB]
+ * @param {string} [options.workspaceRoot]
+ * @returns {string}
+ */
+function formatCollisionError(options) {
+  const {
+    projectName,
+    outputFile,
+    sourceFileA,
+    sourceFileB,
+    ruleIndexA,
+    ruleIndexB,
+    workspaceRoot,
+  } = options;
+
+  const lines = [
+    `[JSKim] 出力パスが衝突しています。`,
+    `プロジェクト: ${projectName}`,
+    `出力: ${toDisplayPath(outputFile, workspaceRoot)}`,
+    formatCollisionSource('ソース1', sourceFileA, ruleIndexA, workspaceRoot),
+    formatCollisionSource('ソース2', sourceFileB, ruleIndexB, workspaceRoot),
+    '同じ出力になるソースを分けるか、どちらかを除外してください。',
+  ];
+
+  return lines.join('\n');
+}
+
+function formatCollisionSource(label, sourceFile, ruleIndex, workspaceRoot) {
+  const display = toDisplayPath(sourceFile, workspaceRoot);
+  if (Number.isInteger(ruleIndex) && ruleIndex >= 0) {
+    return `${label}: ${display} (files[${ruleIndex}])`;
+  }
+  return `${label}: ${display}`;
+}
+
+/**
+ * sourceDir / outputDir 外へのパス逸脱メッセージを組み立てます。
+ *
+ * @param {object} options
+ * @param {string} options.projectName
+ * @param {string} options.label
+ * @param {string} options.root
+ * @param {string} options.candidate
+ * @param {'sourceDir'|'outputDir'|string} [options.rootKind]
+ * @param {string} [options.workspaceRoot]
+ * @returns {string}
+ */
+function formatPathOutsideError(options) {
+  const {
+    projectName,
+    label,
+    root,
+    candidate,
+    rootKind,
+    workspaceRoot,
+  } = options;
+
+  const kindLabel =
+    rootKind === 'sourceDir'
+      ? 'sourceDir'
+      : rootKind === 'outputDir'
+        ? 'outputDir'
+        : '許可ルート';
+
+  return [
+    `[JSKim] プロジェクト "${projectName}" の ${label} が許可範囲外です。`,
+    `種別: ${kindLabel} の外への参照`,
+    `ルート: ${toDisplayPath(root, workspaceRoot)}`,
+    `対象: ${toDisplayPath(candidate, workspaceRoot)}`,
+    '相対パスが sourceDir / outputDir 内に収まるように設定してください。',
+  ].join('\n');
+}
+
+/**
+ * 設定バリデーション向けの共通ヘッダー行を組み立てます。
+ *
+ * @param {object} options
+ * @param {string} options.projectName
+ * @param {string} options.configKey
+ * @param {string} [options.detail]
+ * @param {string} [options.received]
+ * @param {string} [options.hint]
+ * @returns {string}
+ */
+function formatConfigValidationError(options) {
+  const { projectName, configKey, detail, received, hint } = options;
+  const lines = [
+    `[JSKim] 設定値が不正です: ${configKey}`,
+    `プロジェクト: ${projectName}`,
+    `設定キー: projects.${projectName} または defaults の ${configKey}`,
+  ];
+
+  if (detail) {
+    lines.push(detail);
+  }
+  if (received !== undefined) {
+    lines.push(`受け取った値: ${received}`);
+  }
+  if (hint) {
+    lines.push(hint);
+  }
+
+  return lines.join('\n');
+}
+
+/**
+ * 書き込み失敗などの I/O エラーメッセージを組み立てます。
+ *
+ * @param {object} options
+ * @param {string} options.projectName
+ * @param {string} options.actionLabel
+ * @param {string} options.targetFile
+ * @param {string} [options.workspaceRoot]
+ * @param {unknown} options.err
+ * @returns {string}
+ */
+function formatIoError(options) {
+  const { projectName, actionLabel, targetFile, workspaceRoot, err } = options;
+  return [
+    `[JSKim] プロジェクト "${projectName}" の${actionLabel}に失敗しました。`,
+    `対象: ${toDisplayPath(targetFile, workspaceRoot)}`,
+    `原因: ${getCauseMessage(err)}`,
+  ].join('\n');
+}
+
+module.exports = {
+  getCauseMessage,
+  readNunjucksLocation,
+  formatRenderError,
+  formatCollisionError,
+  formatPathOutsideError,
+  formatConfigValidationError,
+  formatIoError,
+};

package/scripts/lib/load-config.js

@@ -1,6 +1,7 @@
 'use strict';
 
 const path = require('node:path');
+const { toDisplayPath } = require('./to-display-path');
 
 const CONFIG_FILENAME = 'jskim.config.js';
 
@@ -11,6 +12,7 @@ const CONFIG_FILENAME = 'jskim.config.js';
  */
 function loadConfig(workspaceRoot) {
   const configPath = path.join(workspaceRoot, CONFIG_FILENAME);
+  const configDisplay = toDisplayPath(configPath, workspaceRoot);
 
   let config;
   try {
@@ -25,21 +27,21 @@ function loadConfig(workspaceRoot) {
 
       if (missingConfig) {
         throw new Error(
-          `[JSKim] 設定ファイルが見つかりません: ${configPath}\n` +
+          `[JSKim] 設定ファイルが見つかりません: ${configDisplay}\n` +
             `ワークスペースルートに ${CONFIG_FILENAME} を作成してください。`
         );
       }
     }
 
     throw new Error(
-      `[JSKim] 設定ファイルの読み込みに失敗しました: ${configPath}\n` +
+      `[JSKim] 設定ファイルの読み込みに失敗しました: ${configDisplay}\n` +
         `原因: ${err && err.message ? err.message : String(err)}`
     );
   }
 
   if (!config || typeof config !== 'object') {
     throw new Error(
-      `[JSKim] 設定が不正です: ${configPath}\n` +
+      `[JSKim] 設定が不正です: ${configDisplay}\n` +
         `原因: module.exports はオブジェクトである必要があります。`
     );
   }
@@ -47,7 +49,7 @@ function loadConfig(workspaceRoot) {
   if (!config.projects || typeof config.projects !== 'object') {
     throw new Error(
       `[JSKim] 設定が不正です: projects が無い、またはオブジェクトではありません。\n` +
-        `設定: ${configPath}`
+        `設定: ${configDisplay}`
     );
   }
 

package/scripts/lib/process-files.js

@@ -5,6 +5,13 @@ const fs = require('node:fs');
 const fse = require('fs-extra');
 const fg = require('fast-glob');
 const { computeRootPath } = require('./render-pages');
+const { toDisplayPath } = require('./to-display-path');
+const {
+  formatRenderError,
+  formatCollisionError,
+  formatPathOutsideError,
+  formatIoError,
+} = require('./format-diagnostic');
 
 const RESERVED_CONTEXT_KEYS = new Set(['rootPath']);
 
@@ -33,14 +40,15 @@ async function processFiles({ env, project }) {
     const fromDir = path.resolve(sourceDir, rule.from);
     const toDir = path.resolve(outputDir, rule.to);
 
-    assertInside(sourceDir, fromDir, name, `files[${i}].from`);
-    assertInside(outputDir, toDir, name, `files[${i}].to`);
+    assertInside(sourceDir, fromDir, name, `files[${i}].from`, 'sourceDir', project.workspaceRoot);
+    assertInside(outputDir, toDir, name, `files[${i}].to`, 'outputDir', project.workspaceRoot);
 
     if (!(await fse.pathExists(fromDir))) {
       throw new Error(
         `[JSKim] プロジェクト "${name}" の files[${i}].from が存在しません。\n` +
-          `パス: ${fromDir}\n` +
-          `設定: files[${i}].from = ${rule.from}`
+          `設定キー: files[${i}].from\n` +
+          `設定値: ${rule.from}\n` +
+          `パス: ${toDisplayPath(fromDir, project.workspaceRoot)}`
       );
     }
 
@@ -67,7 +75,14 @@ async function processFiles({ env, project }) {
         : normalizedRel;
       const outputFile = path.resolve(toDir, outRel.split('/').join(path.sep));
 
-      assertInside(outputDir, outputFile, name, `files[${i}] output`);
+      assertInside(
+        outputDir,
+        outputFile,
+        name,
+        `files[${i}] output`,
+        'outputDir',
+        project.workspaceRoot
+      );
 
       const collisionKey =
         process.platform === 'win32'
@@ -77,11 +92,15 @@ async function processFiles({ env, project }) {
       if (planned.has(collisionKey)) {
         const previous = planned.get(collisionKey);
         throw new Error(
-          `[JSKim] 出力パスが衝突しています。\n` +
-            `プロジェクト: ${name}\n` +
-            `出力: ${toDisplay(outputFile, project.workspaceRoot)}\n` +
-            `ソース1: ${toDisplay(previous.sourceFile, project.workspaceRoot)}\n` +
-            `ソース2: ${toDisplay(sourceFile, project.workspaceRoot)}`
+          formatCollisionError({
+            projectName: name,
+            outputFile,
+            sourceFileA: previous.sourceFile,
+            sourceFileB: sourceFile,
+            ruleIndexA: previous.ruleIndex,
+            ruleIndexB: i,
+            workspaceRoot: project.workspaceRoot,
+          })
         );
       }
 
@@ -103,7 +122,20 @@ async function processFiles({ env, project }) {
     await fse.ensureDir(path.dirname(item.outputFile));
 
     if (item.kind === 'copy') {
-      await fse.copy(item.sourceFile, item.outputFile, { overwrite: true });
+      try {
+        await fse.copy(item.sourceFile, item.outputFile, { overwrite: true });
+      } catch (err) {
+        throw new Error(
+          formatIoError({
+            projectName: name,
+            actionLabel: 'ファイルコピー',
+            targetFile: item.sourceFile,
+            workspaceRoot: project.workspaceRoot,
+            err,
+          }) +
+            `\n出力: ${toDisplayPath(item.outputFile, project.workspaceRoot)}`
+        );
+      }
       copiedCount += 1;
       outputFiles.push(item.outputFile);
       continue;
@@ -120,16 +152,30 @@ async function processFiles({ env, project }) {
     try {
       text = env.render(templatePath, context);
     } catch (err) {
-      const message = err && err.message ? err.message : String(err);
       throw new Error(
-        `[JSKim] プロジェクト "${name}" の Nunjucks レンダリングに失敗しました。\n` +
-          `ソース: ${item.sourceFile}\n` +
-          `テンプレート: ${templatePath}\n` +
-          `原因: ${message}`
+        formatRenderError({
+          projectName: name,
+          sourceFile: item.sourceFile,
+          templatePath,
+          workspaceRoot: project.workspaceRoot,
+          err,
+        })
       );
     }
 
-    await fse.writeFile(item.outputFile, text, 'utf8');
+    try {
+      await fse.writeFile(item.outputFile, text, 'utf8');
+    } catch (err) {
+      throw new Error(
+        formatIoError({
+          projectName: name,
+          actionLabel: 'レンダリング結果の書き込み',
+          targetFile: item.outputFile,
+          workspaceRoot: project.workspaceRoot,
+          err,
+        })
+      );
+    }
     renderedCount += 1;
     outputFiles.push(item.outputFile);
   }
@@ -218,12 +264,17 @@ function samePath(a, b) {
   return na === nb;
 }
 
-function assertInside(root, candidate, projectName, label) {
+function assertInside(root, candidate, projectName, label, rootKind, workspaceRoot) {
   if (!isInsideOrSame(root, candidate)) {
     throw new Error(
-      `[JSKim] プロジェクト "${projectName}" の ${label} が許可範囲外です。\n` +
-        `ルート: ${root}\n` +
-        `対象: ${candidate}`
+      formatPathOutsideError({
+        projectName,
+        label,
+        root,
+        candidate,
+        rootKind,
+        workspaceRoot,
+      })
     );
   }
 }
@@ -235,6 +286,7 @@ function assertNoReservedDataCollision(data, projectName) {
       throw new Error(
         `[JSKim] data のキーが予約語と衝突しています: ${key}\n` +
           `プロジェクト: ${projectName}\n` +
+          `設定キー: data.${key}\n` +
           `予約キー: ${[...RESERVED_CONTEXT_KEYS].join(', ')}`
       );
     }
@@ -248,14 +300,6 @@ function buildRenderContext(data, rootPath) {
   };
 }
 
-function toDisplay(abs, workspaceRoot) {
-  const rel = path.relative(workspaceRoot, abs);
-  if (!rel || rel.startsWith('..') || path.isAbsolute(rel)) {
-    return abs.split(path.sep).join('/');
-  }
-  return rel.split(path.sep).join('/');
-}
-
 module.exports = {
   processFiles,
   stripTrailingNjk,

package/scripts/lib/render-pages.js

@@ -3,6 +3,8 @@
 const path = require('node:path');
 const fse = require('fs-extra');
 const fg = require('fast-glob');
+const { formatRenderError, formatIoError } = require('./format-diagnostic');
+const { toDisplayPath } = require('./to-display-path');
 
 /**
  * 出力ファイルのディレクトリから outputDir までの相対パスとして rootPath を計算します。
@@ -39,7 +41,7 @@ function computeRootPath(outputFilePath, outputDir) {
  * @returns {Promise<{ renderedCount: number, files: string[] }>}
  */
 async function renderPages({ env, project }) {
-  const { name, sourceDir, outputDir, render } = project;
+  const { name, sourceDir, outputDir, render, workspaceRoot } = project;
   let renderedCount = 0;
   const files = [];
 
@@ -54,8 +56,9 @@ async function renderPages({ env, project }) {
     if (!(await fse.pathExists(fromDir))) {
       throw new Error(
         `[JSKim] プロジェクト "${name}" の render[${i}].from が存在しません。\n` +
-          `パス: ${fromDir}\n` +
-          `設定: render[${i}].from = ${rule.from}`
+          `設定キー: render[${i}].from\n` +
+          `設定値: ${rule.from}\n` +
+          `パス: ${toDisplayPath(fromDir, workspaceRoot)}`
       );
     }
 
@@ -94,7 +97,9 @@ async function renderPages({ env, project }) {
       ) {
         throw new Error(
           `[JSKim] data のキーが予約語と衝突しています: rootPath\n` +
-            `プロジェクト: ${name}`
+            `プロジェクト: ${name}\n` +
+            `設定キー: data.rootPath\n` +
+            `予約キー: rootPath`
         );
       }
 
@@ -102,12 +107,14 @@ async function renderPages({ env, project }) {
       try {
         html = env.render(templatePath, context);
       } catch (err) {
-        const message = err && err.message ? err.message : String(err);
         throw new Error(
-          `[JSKim] プロジェクト "${name}" の Nunjucks レンダリングに失敗しました。\n` +
-            `ソース: ${sourceFile}\n` +
-            `テンプレート: ${templatePath}\n` +
-            `原因: ${message}`
+          formatRenderError({
+            projectName: name,
+            sourceFile,
+            templatePath,
+            workspaceRoot,
+            err,
+          })
         );
       }
 
@@ -115,11 +122,14 @@ async function renderPages({ env, project }) {
         await fse.ensureDir(path.dirname(outputFile));
         await fse.writeFile(outputFile, html, 'utf8');
       } catch (err) {
-        const message = err && err.message ? err.message : String(err);
         throw new Error(
-          `[JSKim] プロジェクト "${name}" のレンダリング結果の書き込みに失敗しました。\n` +
-            `出力: ${outputFile}\n` +
-            `原因: ${message}`
+          formatIoError({
+            projectName: name,
+            actionLabel: 'レンダリング結果の書き込み',
+            targetFile: outputFile,
+            workspaceRoot,
+            err,
+          })
         );
       }
 

package/scripts/lib/resolve-project.js

@@ -3,6 +3,7 @@
 const fs = require('node:fs');
 const path = require('node:path');
 const { mergeConfig } = require('./merge-config');
+const { formatConfigValidationError } = require('./format-diagnostic');
 
 /**
  * 読み込んだ設定から名前付きプロジェクトを解決・検証します。
@@ -98,6 +99,7 @@ function resolveProject({
     throw new Error(
       `[JSKim] files と ${conflict.join(' / ')} を同時に設定できません。\n` +
         `プロジェクト: ${name}\n` +
+        `衝突: files と ${conflict.join(' / ')}\n` +
         `files mode を使う場合は render / copy を空にしてください。\n` +
         `legacy mode を使う場合は files を設定しないでください。`
     );
@@ -211,10 +213,13 @@ function validateData(data, projectName) {
   }
   if (typeof data !== 'object' || Array.isArray(data)) {
     throw new Error(
-      `[JSKim] 設定値が不正です: data\n` +
-        `プロジェクト: ${projectName}\n` +
-        `plain object を指定してください（null / array / primitive は不可）。\n` +
-        `受け取った値: ${Array.isArray(data) ? 'array' : typeof data}`
+      formatConfigValidationError({
+        projectName,
+        configKey: 'data',
+        detail:
+          'plain object を指定してください（null / array / primitive は不可）。',
+        received: Array.isArray(data) ? 'array' : typeof data,
+      })
     );
   }
 }
@@ -225,26 +230,35 @@ function validateNunjucks(nunjucks, projectName) {
   }
   if (typeof nunjucks !== 'object' || Array.isArray(nunjucks)) {
     throw new Error(
-      `[JSKim] 設定値が不正です: nunjucks\n` +
-        `プロジェクト: ${projectName}\n` +
-        `plain object を指定してください。`
+      formatConfigValidationError({
+        projectName,
+        configKey: 'nunjucks',
+        detail: 'plain object を指定してください。',
+        received: Array.isArray(nunjucks) ? 'array' : typeof nunjucks,
+      })
     );
   }
 
   const filters = nunjucks.filters || {};
   if (typeof filters !== 'object' || Array.isArray(filters)) {
     throw new Error(
-      `[JSKim] 設定値が不正です: nunjucks.filters\n` +
-        `プロジェクト: ${projectName}\n` +
-        `plain object を指定してください。`
+      formatConfigValidationError({
+        projectName,
+        configKey: 'nunjucks.filters',
+        detail: 'plain object を指定してください。',
+        received: Array.isArray(filters) ? 'array' : typeof filters,
+      })
     );
   }
   for (const [key, value] of Object.entries(filters)) {
     if (typeof value !== 'function') {
       throw new Error(
-        `[JSKim] 設定値が不正です: nunjucks.filters.${key}\n` +
-          `プロジェクト: ${projectName}\n` +
-          `filter は function である必要があります。`
+        formatConfigValidationError({
+          projectName,
+          configKey: `nunjucks.filters.${key}`,
+          detail: 'filter は function である必要があります。',
+          received: typeof value,
+        })
       );
     }
   }
@@ -252,9 +266,12 @@ function validateNunjucks(nunjucks, projectName) {
   const globals = nunjucks.globals || {};
   if (typeof globals !== 'object' || Array.isArray(globals)) {
     throw new Error(
-      `[JSKim] 設定値が不正です: nunjucks.globals\n` +
-        `プロジェクト: ${projectName}\n` +
-        `plain object を指定してください。`
+      formatConfigValidationError({
+        projectName,
+        configKey: 'nunjucks.globals',
+        detail: 'plain object を指定してください。',
+        received: Array.isArray(globals) ? 'array' : typeof globals,
+      })
     );
   }
 }
@@ -268,10 +285,12 @@ function validateWatchConfig(watch, projectName) {
     debounce < 0
   ) {
     throw new Error(
-      `[JSKim] 設定値が不正です: watch.debounce\n` +
-        `プロジェクト: ${projectName}\n` +
-        `0以上の有限な数値を指定してください。\n` +
-        `受け取った値: ${String(debounce)}`
+      formatConfigValidationError({
+        projectName,
+        configKey: 'watch.debounce',
+        detail: '0以上の有限な数値を指定してください。',
+        received: String(debounce),
+      })
     );
   }
 }
@@ -282,10 +301,12 @@ function validateServeConfig(serve, projectName) {
 
   if (typeof host !== 'string' || host.trim() === '') {
     throw new Error(
-      `[JSKim] 設定値が不正です: serve.host\n` +
-        `プロジェクト: ${projectName}\n` +
-        `空でない文字列を指定してください。\n` +
-        `受け取った値: ${String(host)}`
+      formatConfigValidationError({
+        projectName,
+        configKey: 'serve.host',
+        detail: '空でない文字列を指定してください。',
+        received: String(host),
+      })
     );
   }
 
@@ -296,10 +317,12 @@ function validateServeConfig(serve, projectName) {
     port > 65535
   ) {
     throw new Error(
-      `[JSKim] 設定値が不正です: serve.port\n` +
-        `プロジェクト: ${projectName}\n` +
-        `1から65535までの整数を指定してください。\n` +
-        `受け取った値: ${String(port)}`
+      formatConfigValidationError({
+        projectName,
+        configKey: 'serve.port',
+        detail: '1から65535までの整数を指定してください。',
+        received: String(port),
+      })
     );
   }
 }
@@ -309,10 +332,12 @@ function validateDevConfig(dev, projectName) {
 
   if (typeof liveReload !== 'boolean') {
     throw new Error(
-      `[JSKim] 設定値が不正です: dev.liveReload\n` +
-        `プロジェクト: ${projectName}\n` +
-        `boolean を指定してください。\n` +
-        `受け取った値: ${String(liveReload)}`
+      formatConfigValidationError({
+        projectName,
+        configKey: 'dev.liveReload',
+        detail: 'boolean を指定してください。',
+        received: String(liveReload),
+      })
     );
   }
 }

package/scripts/lib/to-display-path.js

@@ -0,0 +1,28 @@
+'use strict';
+
+const path = require('node:path');
+
+/**
+ * ワークスペース相対の表示用パスへ変換します。
+ * @param {string} abs
+ * @param {string} workspaceRoot
+ * @returns {string}
+ */
+function toDisplayPath(abs, workspaceRoot) {
+  if (!abs) {
+    return '';
+  }
+  const resolved = path.resolve(abs);
+  if (!workspaceRoot) {
+    return resolved.split(path.sep).join('/');
+  }
+  const rel = path.relative(workspaceRoot, resolved);
+  if (!rel || rel.startsWith('..') || path.isAbsolute(rel)) {
+    return resolved.split(path.sep).join('/');
+  }
+  return rel.split(path.sep).join('/');
+}
+
+module.exports = {
+  toDisplayPath,
+};