oh-my-customcode 1.1.102 → 1.1.103

package/dist/cli/index.js

@@ -335,7 +335,7 @@ var init_package = __esm(() => {
     workspaces: [
       "packages/*"
     ],
-    version: "1.1.102",
+    version: "1.1.103",
     description: "Batteries-included agent harness for Claude Code",
     type: "module",
     bin: {
@@ -15786,6 +15786,7 @@ var MESSAGES = {
     "lockfile.component_dir_missing": "Component directory missing: {{path}}",
     "lockfile.hash_failed": "Failed to hash file: {{path}} — {{error}}",
     "lockfile.entry_added": "Lockfile entry added: {{path}} ({{component}})",
+    "lockfile.entry_git_excluded": "Lockfile entry skipped (not in git listing): {{path}}",
     "update.start": "Checking for updates...",
     "update.success": "Updated from {{from}} to {{to}}",
     "update.components_synced": "Components synced (version {{version}}): {{components}}",
@@ -15907,6 +15908,7 @@ var MESSAGES = {
     "lockfile.component_dir_missing": "컴포넌트 디렉토리 없음: {{path}}",
     "lockfile.hash_failed": "파일 해시 실패: {{path}} — {{error}}",
     "lockfile.entry_added": "잠금 파일 항목 추가: {{path}} ({{component}})",
+    "lockfile.entry_git_excluded": "잠금 파일 항목 제외 (git 목록에 없음): {{path}}",
     "update.start": "업데이트 확인 중...",
     "update.success": "{{from}}에서 {{to}}로 업데이트 완료",
     "update.components_synced": "컴포넌트 동기화 완료 (버전 {{version}}): {{components}}",
@@ -16362,10 +16364,12 @@ function getComponentPath(component) {
 
 // src/core/lockfile.ts
 init_fs();
+import { execFile } from "node:child_process";
 import { createHash } from "node:crypto";
 import { createReadStream } from "node:fs";
-import { readdir, stat } from "node:fs/promises";
+import { readdir, realpath, stat } from "node:fs/promises";
 import { join as join7, relative as relative2 } from "node:path";
+import { promisify } from "node:util";
 var LOCKFILE_NAME = ".omcustom.lock.json";
 var LOCKFILE_VERSION = 1;
 var LOCKFILE_COMPONENTS = [
@@ -16378,6 +16382,87 @@ var LOCKFILE_COMPONENTS = [
   "guides"
 ];
 var COMPONENT_PATHS = LOCKFILE_COMPONENTS.map((component) => [getComponentPath(component), component]);
+var execFileAsync = promisify(execFile);
+var GIT_LOCATION_ENV_KEYS = [
+  "GIT_DIR",
+  "GIT_WORK_TREE",
+  "GIT_INDEX_FILE",
+  "GIT_PREFIX",
+  "GIT_COMMON_DIR"
+];
+var GIT_INJECTED_CONFIG_ENV_KEYS = ["GIT_CONFIG_PARAMETERS", "GIT_CONFIG_COUNT"];
+var GIT_INJECTED_CONFIG_ENV_PREFIXES = ["GIT_CONFIG_KEY_", "GIT_CONFIG_VALUE_"];
+var GIT_REQUIRED_HINT = "build from a git checkout: excluding ignored local files from the lockfile requires git (#1819)";
+function gitChildEnv() {
+  const env = { ...process.env };
+  for (const key of [...GIT_LOCATION_ENV_KEYS, ...GIT_INJECTED_CONFIG_ENV_KEYS]) {
+    delete env[key];
+  }
+  for (const key of Object.keys(env)) {
+    if (GIT_INJECTED_CONFIG_ENV_PREFIXES.some((prefix) => key.startsWith(prefix))) {
+      delete env[key];
+    }
+  }
+  return env;
+}
+async function runGit(targetDir, args, env) {
+  try {
+    const { stdout } = await execFileAsync("git", args, {
+      cwd: targetDir,
+      env,
+      encoding: "utf-8",
+      maxBuffer: 256 * 1024 * 1024
+    });
+    return stdout;
+  } catch (err) {
+    const detail = err instanceof Error ? err.message.trim() : String(err);
+    throw new Error(`git ${args[0]} failed in ${targetDir}: ${detail} — ${GIT_REQUIRED_HINT}`);
+  }
+}
+function foldCase(nfcPath) {
+  return nfcPath.toLowerCase();
+}
+function isGitVisible(visible, relativePath) {
+  if (visible.exact.has(relativePath)) {
+    return true;
+  }
+  const nfc = relativePath.normalize("NFC");
+  if (visible.nfc.has(nfc)) {
+    return true;
+  }
+  return visible.folded?.has(foldCase(nfc)) ?? false;
+}
+function stripFinalNewline(output) {
+  return output.endsWith(`
+`) ? output.slice(0, -1) : output;
+}
+async function assertGitWorkTreeRoot(targetDir, env) {
+  const topLevel = stripFinalNewline(await runGit(targetDir, ["rev-parse", "--show-toplevel"], env));
+  let realTop;
+  let realTarget;
+  try {
+    [realTop, realTarget] = await Promise.all([realpath(topLevel), realpath(targetDir)]);
+  } catch (err) {
+    const detail = err instanceof Error ? err.message : String(err);
+    throw new Error(`cannot resolve the git work tree root of ${targetDir}: ${detail} — ${GIT_REQUIRED_HINT}`);
+  }
+  if (realTop !== realTarget) {
+    throw new Error(`${targetDir} is not the root of its git work tree (root: ${topLevel}) — ${GIT_REQUIRED_HINT}`);
+  }
+}
+async function listGitVisiblePaths(targetDir) {
+  const env = gitChildEnv();
+  await assertGitWorkTreeRoot(targetDir, env);
+  const pathspecs = COMPONENT_PATHS.map(([prefix]) => prefix);
+  const [listing, ignoreCase] = await Promise.all([
+    runGit(targetDir, ["ls-files", "-z", "--cached", "--others", "--exclude-standard", "--", ...pathspecs], env),
+    runGit(targetDir, ["config", "--type=bool", "--default=false", "--get", "core.ignorecase"], env)
+  ]);
+  const exact = new Set(listing.split("\x00").filter((entry) => entry.length > 0));
+  const nfc = new Set([...exact].map((entry) => entry.normalize("NFC")));
+  const folded = stripFinalNewline(ignoreCase) === "true" ? new Set([...nfc].map(foldCase)) : null;
+  return { exact, nfc, folded };
+}
 function computeFileHash(filePath) {
   return new Promise((resolve, reject) => {
     const hash = createHash("sha256");
@@ -16463,8 +16548,9 @@ function sortFilesByPath(files) {
   const sorted = Object.keys(files).sort((a, b) => a < b ? -1 : a > b ? 1 : 0);
   return Object.fromEntries(sorted.map((key) => [key, files[key]]));
 }
-async function generateLockfile(targetDir, generatorVersion, templateVersion) {
+async function generateLockfile(targetDir, generatorVersion, templateVersion, options = {}) {
   const files = {};
+  const gitVisible = options.excludeGitIgnored ? await listGitVisiblePaths(targetDir) : null;
   const componentRoots = COMPONENT_PATHS.map(([prefix]) => join7(targetDir, prefix));
   for (const componentRoot of componentRoots) {
     const exists = await fileExists(componentRoot);
@@ -16475,6 +16561,10 @@ async function generateLockfile(targetDir, generatorVersion, templateVersion) {
     const allFiles = await collectFiles(componentRoot, targetDir, false);
     for (const absolutePath of allFiles) {
       const relativePath = relative2(targetDir, absolutePath).replace(/\\/g, "/");
+      if (gitVisible !== null && !isGitVisible(gitVisible, relativePath)) {
+        debug("lockfile.entry_git_excluded", { path: relativePath });
+        continue;
+      }
       let hash;
       let size;
       try {
@@ -16535,12 +16625,12 @@ function preserveGeneratedAt(next, previous) {
   }
   return { ...next, generatedAt: previous.generatedAt };
 }
-async function generateAndWriteLockfileForDir(targetDir) {
+async function generateAndWriteLockfileForDir(targetDir, options = {}) {
   try {
     const packageRoot = getPackageRoot();
     const manifest = await readJsonFile(join7(packageRoot, "templates", "manifest.json"));
     const { version: generatorVersion } = await readJsonFile(join7(packageRoot, "package.json"));
-    const generated = await generateLockfile(targetDir, generatorVersion, manifest.version);
+    const generated = await generateLockfile(targetDir, generatorVersion, manifest.version, options);
     const previous = await readLockfile(targetDir);
     const lockfile = preserveGeneratedAt(generated, previous);
     await writeLockfile(targetDir, lockfile);
@@ -20938,11 +21028,30 @@ import { join as join17 } from "node:path";
 // src/cli/serve.ts
 init_home();
 import { spawn } from "node:child_process";
+import { randomUUID } from "node:crypto";
 import { constants as constants3, existsSync as existsSync3 } from "node:fs";
-import { access, readFile as readFile3, unlink, writeFile as writeFile3 } from "node:fs/promises";
+import {
+  access,
+  link,
+  readdir as readdir3,
+  readFile as readFile3,
+  readlink,
+  rename as rename2,
+  stat as stat3,
+  unlink,
+  writeFile as writeFile3
+} from "node:fs/promises";
 import { dirname as dirname7, isAbsolute as isAbsolute4, join as join16 } from "node:path";
+import { setTimeout as delay } from "node:timers/promises";
 var DEFAULT_PORT = 4321;
 var PID_FILE_NAME = ".omcustom-serve.pid";
+var STARTING_RECORD = /^starting:(\d+):/;
+var MAX_CLAIM_ATTEMPTS = 3;
+var CLAIM_MAX_AGE_MS = 60000;
+var PARTIAL_RECORD_GRACE_MS = 1e4;
+var ABSENT_RETRY_DELAY_MS = 10;
+var HARD_LINK_UNSUPPORTED = new Set(["ENOTSUP", "EOPNOTSUPP", "EPERM", "EXDEV"]);
+var SIBLING_REMNANT = /^\.omcustom-serve\.pid\.(\d+)\.[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\.(?:tmp|taken)$/;
 
 class ServePidFileError extends Error {
   reason;
@@ -20972,6 +21081,51 @@ function findServeBuildDir(projectRoot, options) {
   }
   return null;
 }
+function parsePidRecord(raw) {
+  const text = raw.trim();
+  const match = STARTING_RECORD.exec(text);
+  const pid = Number(match === null ? text : match[1]);
+  if (!Number.isFinite(pid) || pid <= 0) {
+    return null;
+  }
+  return { pid, starting: match !== null };
+}
+function isProcessAlive(pid) {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function errorCode(error) {
+  return error?.code;
+}
+async function isOlderThan(path, ms) {
+  try {
+    const { mtimeMs } = await stat3(path);
+    return Date.now() - mtimeMs >= ms;
+  } catch {
+    return false;
+  }
+}
+async function isRecordLive(pidFile, record) {
+  if (!isProcessAlive(record.pid)) {
+    return false;
+  }
+  return !record.starting || !await isOlderThan(pidFile, CLAIM_MAX_AGE_MS);
+}
+async function readPidFileSettled(pidFile) {
+  try {
+    return await readFile3(pidFile, "utf-8");
+  } catch (error) {
+    if (errorCode(error) !== "ENOENT") {
+      throw error;
+    }
+  }
+  await delay(ABSENT_RETRY_DELAY_MS);
+  return readFile3(pidFile, "utf-8");
+}
 async function isServeRunning() {
   const pidFile = resolveServePidFile();
   if (pidFile === null) {
@@ -20980,19 +21134,14 @@ async function isServeRunning() {
   return isServeRunningAt(pidFile);
 }
 async function isServeRunningAt(pidFile) {
+  let raw;
   try {
-    const raw = await readFile3(pidFile, "utf-8");
-    const pid = Number(raw.trim());
-    if (!Number.isFinite(pid) || pid <= 0) {
-      await cleanupPidFile(pidFile);
-      return false;
-    }
-    process.kill(pid, 0);
-    return true;
+    raw = await readPidFileSettled(pidFile);
   } catch {
-    await cleanupPidFile(pidFile);
     return false;
   }
+  const record = parsePidRecord(raw);
+  return record !== null && await isRecordLive(pidFile, record);
 }
 async function startServeBackground(projectRoot, port = DEFAULT_PORT, buildDirOpts) {
   const pidFile = resolveServePidFile();
@@ -21011,6 +21160,15 @@ async function startServeBackground(projectRoot, port = DEFAULT_PORT, buildDirOp
   } catch (error) {
     throw new ServePidFileError("pid-not-writable", pidFile, { cause: error });
   }
+  let claim;
+  try {
+    claim = await claimPidFile(pidFile);
+  } catch (error) {
+    throw new ServePidFileError("pid-not-writable", pidFile, { cause: error });
+  }
+  if (claim === null) {
+    return;
+  }
   const child = spawn("node", [join16(buildDir, "index.js")], {
     env: {
       ...process.env,
@@ -21025,38 +21183,217 @@ async function startServeBackground(projectRoot, port = DEFAULT_PORT, buildDirOp
   child.on("error", () => {});
   child.unref();
   if (child.pid === undefined) {
+    await removePidFileIf(pidFile, claim);
     return;
   }
+  let recorded;
   try {
-    await writeFile3(pidFile, String(child.pid), "utf-8");
+    recorded = await recordServerPid(pidFile, claim, String(child.pid));
   } catch (error) {
     child.kill("SIGTERM");
+    await removePidFileIf(pidFile, claim);
     throw new ServePidFileError("pid-not-writable", pidFile, { cause: error });
   }
+  if (!recorded) {
+    child.kill("SIGTERM");
+  }
+}
+async function recordServerPid(pidFile, claim, pid) {
+  for (let attempt = 0;attempt < MAX_CLAIM_ATTEMPTS; attempt++) {
+    if (await createPidFileExclusive(pidFile, pid)) {
+      return true;
+    }
+    let current;
+    try {
+      current = await readFile3(pidFile, "utf-8");
+    } catch (error) {
+      if (errorCode(error) === "ENOENT") {
+        continue;
+      }
+      throw error;
+    }
+    if (current !== claim) {
+      return false;
+    }
+    await replacePidFile(pidFile, pid);
+    return true;
+  }
+  return false;
 }
 async function stopServe() {
   const pidFile = resolveServePidFile();
   if (pidFile === null) {
     return false;
   }
+  let raw;
   try {
-    const raw = await readFile3(pidFile, "utf-8");
-    const pid = Number(raw.trim());
-    if (!Number.isFinite(pid) || pid <= 0) {
-      await cleanupPidFile(pidFile);
-      return false;
+    raw = await readPidFileSettled(pidFile);
+  } catch {
+    return false;
+  }
+  const record = parsePidRecord(raw);
+  if (record === null || record.starting) {
+    return false;
+  }
+  try {
+    process.kill(record.pid, "SIGTERM");
+  } catch {
+    return false;
+  }
+  await removePidFileIf(pidFile, raw);
+  return true;
+}
+function siblingPath(pidFile, suffix) {
+  return `${pidFile}.${process.pid}.${randomUUID()}.${suffix}`;
+}
+async function claimPidFile(pidFile) {
+  await removeDeadSiblings(pidFile);
+  const claim = `starting:${process.pid}:${randomUUID()}`;
+  for (let attempt = 0;attempt < MAX_CLAIM_ATTEMPTS; attempt++) {
+    if (await createPidFileExclusive(pidFile, claim)) {
+      return claim;
     }
-    process.kill(pid, "SIGTERM");
-    await cleanupPidFile(pidFile);
+    let raw;
+    try {
+      raw = await readFile3(pidFile, "utf-8");
+    } catch (error) {
+      if (errorCode(error) === "ENOENT") {
+        await removeDanglingLink(pidFile);
+        continue;
+      }
+      throw error;
+    }
+    if (await isRecordHeld(pidFile, raw)) {
+      return null;
+    }
+    await removePidFileIf(pidFile, raw);
+  }
+  return null;
+}
+async function isRecordHeld(pidFile, raw) {
+  const record = parsePidRecord(raw);
+  if (record === null) {
+    return isPossiblyPartialRecord(raw) && !await isOlderThan(pidFile, PARTIAL_RECORD_GRACE_MS);
+  }
+  return isRecordLive(pidFile, record);
+}
+function isPossiblyPartialRecord(raw) {
+  return "starting:".startsWith(raw) || /^starting:\d*$/.test(raw);
+}
+async function removeDeadSiblings(pidFile) {
+  const dir = dirname7(pidFile);
+  let names;
+  try {
+    names = await readdir3(dir);
+  } catch {
+    return;
+  }
+  for (const name of names) {
+    const match = SIBLING_REMNANT.exec(name);
+    if (match !== null && isProcessGone(Number(match[1]))) {
+      await unlinkQuietly(join16(dir, name));
+    }
+  }
+}
+function isProcessGone(pid) {
+  try {
+    process.kill(pid, 0);
+    return false;
+  } catch (error) {
+    return errorCode(error) === "ESRCH";
+  }
+}
+async function createPidFileExclusive(pidFile, content) {
+  const staged = siblingPath(pidFile, "tmp");
+  try {
+    await writeFile3(staged, content, { encoding: "utf-8", flag: "wx" });
+    await linkExclusive(staged, pidFile, content);
     return true;
+  } catch (error) {
+    if (errorCode(error) === "EEXIST") {
+      return false;
+    }
+    throw error;
+  } finally {
+    await unlinkQuietly(staged);
+  }
+}
+async function linkExclusive(source, target, content) {
+  try {
+    await link(source, target);
+  } catch (error) {
+    if (!HARD_LINK_UNSUPPORTED.has(errorCode(error) ?? "")) {
+      throw error;
+    }
+    await writeFile3(target, content, { encoding: "utf-8", flag: "wx" });
+  }
+}
+async function replacePidFile(pidFile, content) {
+  const staged = siblingPath(pidFile, "tmp");
+  try {
+    await writeFile3(staged, content, { encoding: "utf-8", flag: "wx" });
+    await rename2(staged, pidFile);
+  } catch (error) {
+    await unlinkQuietly(staged);
+    throw error;
+  }
+}
+async function removePidFileIf(pidFile, expected) {
+  await removePidFileWhen(pidFile, async (taken) => {
+    try {
+      return await readFile3(taken, "utf-8") === expected;
+    } catch {
+      return false;
+    }
+  });
+}
+async function removeDanglingLink(pidFile) {
+  if (!await isDanglingLink(pidFile)) {
+    return;
+  }
+  await removePidFileWhen(pidFile, isDanglingLink);
+}
+async function isDanglingLink(path) {
+  try {
+    await readlink(path);
   } catch {
-    await cleanupPidFile(pidFile);
     return false;
   }
+  try {
+    await stat3(path);
+    return false;
+  } catch {
+    return true;
+  }
+}
+async function removePidFileWhen(pidFile, isExpected) {
+  const taken = siblingPath(pidFile, "taken");
+  try {
+    await rename2(pidFile, taken);
+  } catch {
+    return;
+  }
+  if (!await isExpected(taken)) {
+    await putBack(taken, pidFile);
+  }
+  await unlinkQuietly(taken);
+}
+async function putBack(taken, pidFile) {
+  try {
+    await link(taken, pidFile);
+    return;
+  } catch (error) {
+    if (!HARD_LINK_UNSUPPORTED.has(errorCode(error) ?? "")) {
+      return;
+    }
+  }
+  try {
+    await writeFile3(pidFile, await readFile3(taken, "utf-8"), { encoding: "utf-8", flag: "wx" });
+  } catch {}
 }
-async function cleanupPidFile(pidFile) {
+async function unlinkQuietly(path) {
   try {
-    await unlink(pidFile);
+    await unlink(path);
   } catch {}
 }
 

package/dist/index.js

@@ -404,6 +404,7 @@ var MESSAGES = {
     "lockfile.component_dir_missing": "Component directory missing: {{path}}",
     "lockfile.hash_failed": "Failed to hash file: {{path}} — {{error}}",
     "lockfile.entry_added": "Lockfile entry added: {{path}} ({{component}})",
+    "lockfile.entry_git_excluded": "Lockfile entry skipped (not in git listing): {{path}}",
     "update.start": "Checking for updates...",
     "update.success": "Updated from {{from}} to {{to}}",
     "update.components_synced": "Components synced (version {{version}}): {{components}}",
@@ -525,6 +526,7 @@ var MESSAGES = {
     "lockfile.component_dir_missing": "컴포넌트 디렉토리 없음: {{path}}",
     "lockfile.hash_failed": "파일 해시 실패: {{path}} — {{error}}",
     "lockfile.entry_added": "잠금 파일 항목 추가: {{path}} ({{component}})",
+    "lockfile.entry_git_excluded": "잠금 파일 항목 제외 (git 목록에 없음): {{path}}",
     "update.start": "업데이트 확인 중...",
     "update.success": "{{from}}에서 {{to}}로 업데이트 완료",
     "update.components_synced": "컴포넌트 동기화 완료 (버전 {{version}}): {{components}}",
@@ -2035,10 +2037,12 @@ function getComponentPath(component) {
 
 // src/core/lockfile.ts
 init_fs();
+import { execFile } from "node:child_process";
 import { createHash } from "node:crypto";
 import { createReadStream } from "node:fs";
-import { readdir, stat } from "node:fs/promises";
+import { readdir, realpath, stat } from "node:fs/promises";
 import { join as join4, relative as relative2 } from "node:path";
+import { promisify } from "node:util";
 var LOCKFILE_NAME = ".omcustom.lock.json";
 var LOCKFILE_VERSION = 1;
 var LOCKFILE_COMPONENTS = [
@@ -2051,6 +2055,87 @@ var LOCKFILE_COMPONENTS = [
   "guides"
 ];
 var COMPONENT_PATHS = LOCKFILE_COMPONENTS.map((component) => [getComponentPath(component), component]);
+var execFileAsync = promisify(execFile);
+var GIT_LOCATION_ENV_KEYS = [
+  "GIT_DIR",
+  "GIT_WORK_TREE",
+  "GIT_INDEX_FILE",
+  "GIT_PREFIX",
+  "GIT_COMMON_DIR"
+];
+var GIT_INJECTED_CONFIG_ENV_KEYS = ["GIT_CONFIG_PARAMETERS", "GIT_CONFIG_COUNT"];
+var GIT_INJECTED_CONFIG_ENV_PREFIXES = ["GIT_CONFIG_KEY_", "GIT_CONFIG_VALUE_"];
+var GIT_REQUIRED_HINT = "build from a git checkout: excluding ignored local files from the lockfile requires git (#1819)";
+function gitChildEnv() {
+  const env = { ...process.env };
+  for (const key of [...GIT_LOCATION_ENV_KEYS, ...GIT_INJECTED_CONFIG_ENV_KEYS]) {
+    delete env[key];
+  }
+  for (const key of Object.keys(env)) {
+    if (GIT_INJECTED_CONFIG_ENV_PREFIXES.some((prefix) => key.startsWith(prefix))) {
+      delete env[key];
+    }
+  }
+  return env;
+}
+async function runGit(targetDir, args, env) {
+  try {
+    const { stdout } = await execFileAsync("git", args, {
+      cwd: targetDir,
+      env,
+      encoding: "utf-8",
+      maxBuffer: 256 * 1024 * 1024
+    });
+    return stdout;
+  } catch (err) {
+    const detail = err instanceof Error ? err.message.trim() : String(err);
+    throw new Error(`git ${args[0]} failed in ${targetDir}: ${detail} — ${GIT_REQUIRED_HINT}`);
+  }
+}
+function foldCase(nfcPath) {
+  return nfcPath.toLowerCase();
+}
+function isGitVisible(visible, relativePath) {
+  if (visible.exact.has(relativePath)) {
+    return true;
+  }
+  const nfc = relativePath.normalize("NFC");
+  if (visible.nfc.has(nfc)) {
+    return true;
+  }
+  return visible.folded?.has(foldCase(nfc)) ?? false;
+}
+function stripFinalNewline(output) {
+  return output.endsWith(`
+`) ? output.slice(0, -1) : output;
+}
+async function assertGitWorkTreeRoot(targetDir, env) {
+  const topLevel = stripFinalNewline(await runGit(targetDir, ["rev-parse", "--show-toplevel"], env));
+  let realTop;
+  let realTarget;
+  try {
+    [realTop, realTarget] = await Promise.all([realpath(topLevel), realpath(targetDir)]);
+  } catch (err) {
+    const detail = err instanceof Error ? err.message : String(err);
+    throw new Error(`cannot resolve the git work tree root of ${targetDir}: ${detail} — ${GIT_REQUIRED_HINT}`);
+  }
+  if (realTop !== realTarget) {
+    throw new Error(`${targetDir} is not the root of its git work tree (root: ${topLevel}) — ${GIT_REQUIRED_HINT}`);
+  }
+}
+async function listGitVisiblePaths(targetDir) {
+  const env = gitChildEnv();
+  await assertGitWorkTreeRoot(targetDir, env);
+  const pathspecs = COMPONENT_PATHS.map(([prefix]) => prefix);
+  const [listing, ignoreCase] = await Promise.all([
+    runGit(targetDir, ["ls-files", "-z", "--cached", "--others", "--exclude-standard", "--", ...pathspecs], env),
+    runGit(targetDir, ["config", "--type=bool", "--default=false", "--get", "core.ignorecase"], env)
+  ]);
+  const exact = new Set(listing.split("\x00").filter((entry) => entry.length > 0));
+  const nfc = new Set([...exact].map((entry) => entry.normalize("NFC")));
+  const folded = stripFinalNewline(ignoreCase) === "true" ? new Set([...nfc].map(foldCase)) : null;
+  return { exact, nfc, folded };
+}
 function computeFileHash(filePath) {
   return new Promise((resolve, reject) => {
     const hash = createHash("sha256");
@@ -2136,8 +2221,9 @@ function sortFilesByPath(files) {
   const sorted = Object.keys(files).sort((a, b) => a < b ? -1 : a > b ? 1 : 0);
   return Object.fromEntries(sorted.map((key) => [key, files[key]]));
 }
-async function generateLockfile(targetDir, generatorVersion, templateVersion) {
+async function generateLockfile(targetDir, generatorVersion, templateVersion, options = {}) {
   const files = {};
+  const gitVisible = options.excludeGitIgnored ? await listGitVisiblePaths(targetDir) : null;
   const componentRoots = COMPONENT_PATHS.map(([prefix]) => join4(targetDir, prefix));
   for (const componentRoot of componentRoots) {
     const exists = await fileExists(componentRoot);
@@ -2148,6 +2234,10 @@ async function generateLockfile(targetDir, generatorVersion, templateVersion) {
     const allFiles = await collectFiles(componentRoot, targetDir, false);
     for (const absolutePath of allFiles) {
       const relativePath = relative2(targetDir, absolutePath).replace(/\\/g, "/");
+      if (gitVisible !== null && !isGitVisible(gitVisible, relativePath)) {
+        debug("lockfile.entry_git_excluded", { path: relativePath });
+        continue;
+      }
       let hash;
       let size;
       try {
@@ -2208,12 +2298,12 @@ function preserveGeneratedAt(next, previous) {
   }
   return { ...next, generatedAt: previous.generatedAt };
 }
-async function generateAndWriteLockfileForDir(targetDir) {
+async function generateAndWriteLockfileForDir(targetDir, options = {}) {
   try {
     const packageRoot = getPackageRoot();
     const manifest = await readJsonFile(join4(packageRoot, "templates", "manifest.json"));
     const { version: generatorVersion } = await readJsonFile(join4(packageRoot, "package.json"));
-    const generated = await generateLockfile(targetDir, generatorVersion, manifest.version);
+    const generated = await generateLockfile(targetDir, generatorVersion, manifest.version, options);
     const previous = await readLockfile(targetDir);
     const lockfile = preserveGeneratedAt(generated, previous);
     await writeLockfile(targetDir, lockfile);
@@ -2853,7 +2943,7 @@ var package_default = {
   workspaces: [
     "packages/*"
   ],
-  version: "1.1.102",
+  version: "1.1.103",
   description: "Batteries-included agent harness for Claude Code",
   type: "module",
   bin: {

package/package.json

@@ -3,7 +3,7 @@
   "workspaces": [
     "packages/*"
   ],
-  "version": "1.1.102",
+  "version": "1.1.103",
   "description": "Batteries-included agent harness for Claude Code",
   "type": "module",
   "bin": {

package/templates/.claude/output-styles/korean-engineer.md

@@ -56,7 +56,7 @@ ecomode 활성 시 자동으로 concise 모드로 전환 (R013).
 
 ## 위임 모델 (R010)
 
-오케스트레이터(메인 대화)는 파일 수정 금지 → 서브에이전트에 위임. Agent tool 호출 시 항상 `mode: "bypassPermissions"` 명시.
+오케스트레이터(메인 대화)는 파일 수정 금지 → 서브에이전트에 위임. CC < 2.1.212에서는 Agent 도구 호출 시 `mode: "bypassPermissions"`가 필요하므로 호환을 위해 명시합니다. 2.1.212+에서는 `mode`가 무시되고 서브에이전트가 부모 세션의 권한 모드를 상속합니다(frontmatter `permissionMode`로 조정 가능). 무인 실행 전 유효 모드는 R010 「Universal bypassPermissions」 절차로 실측합니다.
 
 ## 작업 완료 검증 (R020)