oh-my-customcodex 0.2.0 → 0.3.0

package/README.md

@@ -29,7 +29,7 @@ oh-my-customcodex is built on two ideas:
 
 | Compile Concept | oh-my-customcodex |
 |----------------|-----------------|
-| Source code | `.codex/skills/` — reusable knowledge and workflows |
+| Source code | `.agents/skills/` — reusable knowledge and workflows |
 | Build artifacts | `.codex/agents/` — executable specialists assembled from skills |
 | Compiler | `mgr-sauron` (R017) — structural verification and integrity |
 | Spec | `.codex/rules/` — constraints and build rules |
@@ -225,7 +225,7 @@ Key rules: R010 (orchestrator never writes files), R009 (parallel execution mand
 
 ---
 
-### Guides (39)
+### Guides (40)
 
 Reference documentation covering best practices, architecture decisions, and integration patterns. Located in `guides/` at project root, covering topics from agent design to CI/CD to observability.
 
@@ -282,7 +282,11 @@ your-project/
 │   ├── specs/                  # Extracted canonical specs
 │   ├── contexts/               # 4 shared context files
 │   └── ontology/               # Knowledge graph for RAG
-└── guides/                     # 39 reference documents
+<<<<<<< HEAD
+└── guides/                     # 40 reference documents
+=======
+└── guides/                     # 40 reference documents
+>>>>>>> origin/develop
 ```
 
 ---

package/dist/cli/index.js

@@ -2653,6 +2653,9 @@ function getComponentPath(component, provider = "codex") {
   if (component === "guides") {
     return "guides";
   }
+  if (provider === "codex" && component === "skills") {
+    return ".agents/skills";
+  }
   return `${layout.rootDir}/${component}`;
 }
 function getTemplateComponentPath(component, provider = "codex") {
@@ -2681,8 +2684,9 @@ var init_layout = __esm(() => {
       ".codex/hooks",
       ".codex/contexts",
       ".codex/agents",
-      ".codex/skills",
       ".codex/ontology",
+      ".agents",
+      ".agents/skills",
       "guides"
     ]
   };
@@ -3087,12 +3091,14 @@ var init_package = __esm(() => {
     workspaces: [
       "packages/*"
     ],
-    version: "0.2.0",
+    version: "0.3.0",
     description: "Batteries-included agent harness on top of GPT Codex + OMX",
     type: "module",
     bin: {
       omcodex: "./dist/cli/index.js",
-      omcustom: "./dist/cli/index.js"
+      omcustom: "./dist/cli/index.js",
+      omcustomx: "./dist/cli/index.js",
+      omcustomcodex: "./dist/cli/index.js"
     },
     main: "./dist/index.js",
     types: "./dist/index.d.ts",
@@ -3173,6 +3179,40 @@ var init_package = __esm(() => {
   };
 });
 
+// src/utils/cli-command-name.ts
+import { basename as basename2 } from "node:path";
+function normalizeCliCommandName(commandName) {
+  const normalized = commandName?.trim().toLowerCase().replace(WINDOWS_SCRIPT_EXTENSIONS, "");
+  return normalized && KNOWN_CLI_COMMANDS.has(normalized) ? normalized : DEFAULT_CLI_COMMAND;
+}
+function detectCliCommandName(argv = process.argv) {
+  const invokedPath = argv[1];
+  if (!invokedPath) {
+    return DEFAULT_CLI_COMMAND;
+  }
+  const normalizedPath = invokedPath.replace(/\\/g, "/");
+  return normalizeCliCommandName(basename2(normalizedPath));
+}
+function setActiveCliCommandName(commandName) {
+  activeCliCommandName = normalizeCliCommandName(commandName);
+}
+function getActiveCliCommandName() {
+  return activeCliCommandName;
+}
+function rewriteCliCommandReferences(text, commandName = getActiveCliCommandName()) {
+  const normalizedCommandName = normalizeCliCommandName(commandName);
+  if (normalizedCommandName === DEFAULT_CLI_COMMAND) {
+    return text;
+  }
+  return text.replace(/(^|[^A-Za-z0-9_.-])omcodex(?=$|[^A-Za-z0-9_.-])/g, (_match, prefix) => `${prefix}${normalizedCommandName}`);
+}
+var DEFAULT_CLI_COMMAND = "omcodex", KNOWN_CLI_COMMANDS, WINDOWS_SCRIPT_EXTENSIONS, activeCliCommandName;
+var init_cli_command_name = __esm(() => {
+  KNOWN_CLI_COMMANDS = new Set([DEFAULT_CLI_COMMAND, "omcustom", "omcustomx", "omcustomcodex"]);
+  WINDOWS_SCRIPT_EXTENSIONS = /\.(cmd|exe|ps1|bat)$/i;
+  activeCliCommandName = DEFAULT_CLI_COMMAND;
+});
+
 // node_modules/.bun/yaml@2.8.2/node_modules/yaml/dist/nodes/identity.js
 var require_identity = __commonJS((exports) => {
   var ALIAS = Symbol.for("yaml.alias");
@@ -10085,7 +10125,7 @@ __export(exports_projects, {
   default: () => projects_default
 });
 import { homedir as homedir3 } from "node:os";
-import { basename as basename4, join as join9, sep as sep3 } from "node:path";
+import { basename as basename5, join as join9, sep as sep3 } from "node:path";
 async function readLockFile(projectDir) {
   const fs2 = await import("node:fs/promises");
   for (const lockFilePath of [
@@ -10145,7 +10185,7 @@ async function findProjects(options = {}) {
   if (Object.keys(registry.projects).length === 0) {
     const fallbackResults = await _findProjectsFromLockfiles(options, currentVersion);
     if (fallbackResults.length === 0 && !options.paths) {
-      process.stderr.write("  No projects in registry. Run `omcodex projects --migrate` to import existing projects.\n");
+      process.stderr.write(rewriteCliCommandReferences("  No projects in registry. Run `omcodex projects --migrate` to import existing projects.\n"));
     }
     return fallbackResults;
   }
@@ -10157,7 +10197,7 @@ async function findProjects(options = {}) {
     if (!isUnderHome(projectPath, home))
       continue;
     results.push({
-      name: basename4(projectPath),
+      name: basename5(projectPath),
       path: projectPath,
       version: entry.version || null,
       installedAt: entry.installedAt || null,
@@ -10183,7 +10223,7 @@ async function _scanDirForLockfiles(dir2, depth, seen, results, home, currentVer
     if (isUnderHome(dir2, home)) {
       const version = lockFile.version || lockFile.templateVersion || null;
       results.push({
-        name: basename4(dir2),
+        name: basename5(dir2),
         path: dir2,
         version,
         installedAt: lockFile.installedAt || null,
@@ -10233,7 +10273,7 @@ function formatProjectsTable(projects, currentVersion) {
   if (projects.length === 0) {
     console.log(`
   oh-my-customcodex가 적용된 프로젝트를 찾을 수 없습니다.`);
-    console.log("  레지스트리가 비어 있습니다. `omcodex projects --migrate`를 실행하여 기존 프로젝트를 가져오세요.\n");
+    console.log(rewriteCliCommandReferences("  레지스트리가 비어 있습니다. `omcodex projects --migrate`를 실행하여 기존 프로젝트를 가져오세요.\n"));
     return;
   }
   const nameWidth = Math.max(20, ...projects.map((p) => p.name.length));
@@ -10340,6 +10380,7 @@ var SCAN_SKIP_DIRS2, projects_default;
 var init_projects = __esm(() => {
   init_package();
   init_registry();
+  init_cli_command_name();
   init_fs();
   SCAN_SKIP_DIRS2 = new Set(["node_modules", "dist", "build", ".git"]);
   projects_default = projectsCommand;
@@ -22737,7 +22778,10 @@ var init_dist17 = __esm(() => {
 });
 
 // src/cli/index.ts
+import { realpathSync } from "node:fs";
 import { createRequire as createRequire2 } from "node:module";
+import { resolve as resolve4 } from "node:path";
+import { fileURLToPath as fileURLToPath3 } from "node:url";
 
 // node_modules/.bun/commander@14.0.2/node_modules/commander/esm.mjs
 var import__ = __toESM(require_commander(), 1);
@@ -25392,6 +25436,9 @@ var setDefaultNamespace = instance.setDefaultNamespace;
 var hasLoadedNamespace = instance.hasLoadedNamespace;
 var loadNamespaces = instance.loadNamespaces;
 var loadLanguages = instance.loadLanguages;
+
+// src/i18n/index.ts
+init_cli_command_name();
 // src/i18n/locales/en.json
 var en_default = {
   common: {
@@ -26275,7 +26322,7 @@ async function initI18n(language) {
 }
 var i18n = {
   t(key, options) {
-    return instance.t(key, options);
+    return rewriteCliCommandReferences(instance.t(key, options));
   },
   async changeLanguage(language) {
     await instance.changeLanguage(language);
@@ -26606,6 +26653,9 @@ async function maybeHandleSelfUpdateForInit(options) {
   runGlobalUpdate(packageName, latestVersion);
 }
 
+// src/cli/index.ts
+init_cli_command_name();
+
 // src/cli/doctor.ts
 import { constants, promises as fs, readFileSync as readFileSync2 } from "node:fs";
 import path from "node:path";
@@ -27193,8 +27243,8 @@ async function checkAgents(targetDir, rootDir = ".codex") {
     fixable: false
   };
 }
-async function checkSymlinks(targetDir, rootDir = ".codex") {
-  const skillsDir = path.join(targetDir, rootDir, "skills");
+async function checkSymlinks(targetDir, _rootDir = ".codex") {
+  const skillsDir = path.join(targetDir, getComponentPath("skills"));
   const brokenSymlinks = [];
   if (await isDirectory(skillsDir)) {
     const skillSymlinks = await findRefsSymlinks(skillsDir);
@@ -27255,8 +27305,8 @@ async function checkIndexFiles(targetDir) {
     fixable: false
   };
 }
-async function checkSkills(targetDir, rootDir = ".codex") {
-  const skillsDir = path.join(targetDir, rootDir, "skills");
+async function checkSkills(targetDir, _rootDir = ".codex") {
+  const skillsDir = path.join(targetDir, getComponentPath("skills"));
   const exists2 = await isDirectory(skillsDir);
   if (!exists2) {
     return {
@@ -27479,7 +27529,7 @@ async function fixSingleIssue(check, targetDir, rootDir = ".codex") {
   const fixMap = {
     Rules: () => createMissingDirectory(path.join(targetDir, rootDir, "rules")),
     Agents: () => createMissingDirectory(path.join(targetDir, rootDir, "agents")),
-    Skills: () => createMissingDirectory(path.join(targetDir, rootDir, "skills")),
+    Skills: () => createMissingDirectory(path.join(targetDir, getComponentPath("skills"))),
     Guides: () => createMissingDirectory(path.join(targetDir, "guides")),
     Hooks: () => createMissingDirectory(path.join(targetDir, rootDir, "hooks")),
     Contexts: () => createMissingDirectory(path.join(targetDir, rootDir, "contexts")),
@@ -27719,19 +27769,19 @@ import {
   rename,
   stat as stat2
 } from "node:fs/promises";
-import { basename as basename3, join as join7 } from "node:path";
+import { basename as basename4, join as join7 } from "node:path";
 
 // src/core/file-preservation.ts
 init_fs();
 init_logger();
-import { basename as basename2, join as join6 } from "node:path";
+import { basename as basename3, join as join6 } from "node:path";
 var DEFAULT_CRITICAL_FILES = ["settings.json", "settings.local.json"];
 var DEFAULT_CRITICAL_DIRECTORIES = ["agent-memory", "agent-memory-local"];
 var PROTECTED_FRAMEWORK_FILES = ["CLAUDE.md", "AGENTS.md"];
 var PROTECTED_RULE_PATTERNS = ["rules/MUST-*.md"];
 function isProtectedFile(relativePath) {
-  const basename3 = relativePath.split("/").pop() ?? "";
-  if (PROTECTED_FRAMEWORK_FILES.includes(basename3)) {
+  const basename4 = relativePath.split("/").pop() ?? "";
+  if (PROTECTED_FRAMEWORK_FILES.includes(basename4)) {
     return true;
   }
   for (const pattern of PROTECTED_RULE_PATTERNS) {
@@ -27840,10 +27890,10 @@ async function mergeJsonFile(preservedPath, targetPath) {
     const targetData = await readJsonFile(targetPath);
     const merged = deepMerge(targetData, preservedData);
     await writeJsonFile(targetPath, merged);
-    debug("preserve.merged_json", { file: basename2(targetPath) });
+    debug("preserve.merged_json", { file: basename3(targetPath) });
   } else {
     await copyFile(preservedPath, targetPath);
-    debug("preserve.copied_json", { file: basename2(targetPath) });
+    debug("preserve.copied_json", { file: basename3(targetPath) });
   }
 }
 function deepMerge(target, source) {
@@ -28517,7 +28567,7 @@ async function installEntryDoc(targetDir, language, overwrite = false) {
   return true;
 }
 async function backupExisting(sourcePath, backupDir) {
-  const name = basename3(sourcePath);
+  const name = basename4(sourcePath);
   const backupPath = join7(backupDir, name);
   await rename(sourcePath, backupPath);
   return backupPath;
@@ -28525,6 +28575,9 @@ async function backupExisting(sourcePath, backupDir) {
 async function checkExistingPaths(targetDir) {
   const layout = getProviderLayout();
   const pathsToCheck = [layout.entryFile, layout.rootDir, "guides"];
+  if (layout.provider === "codex") {
+    pathsToCheck.push(".agents");
+  }
   const existingPaths = [];
   for (const relativePath of pathsToCheck) {
     const fullPath = join7(targetDir, relativePath);
@@ -28649,51 +28702,101 @@ init_layout();
 init_registry();
 async function checkExistingInstallation(targetDir) {
   const layout = getProviderLayout();
-  const rootDir = join10(targetDir, layout.rootDir);
-  return fileExists(rootDir);
+  const markers = [layout.entryFile, layout.rootDir];
+  if (layout.provider === "codex") {
+    markers.push(".agents");
+  }
+  for (const marker of markers) {
+    if (await fileExists(join10(targetDir, marker))) {
+      return true;
+    }
+  }
+  return false;
 }
-async function installFromSnapshot(targetDir, snapshotPath, options) {
+function getSnapshotPaths(snapshotPath) {
+  const layout = getProviderLayout();
+  return {
+    layout,
+    snapshotRuntime: join10(snapshotPath, layout.rootDir),
+    snapshotSkills: join10(snapshotPath, getComponentPath("skills")),
+    snapshotGuides: join10(snapshotPath, "guides"),
+    snapshotEntry: join10(snapshotPath, layout.entryFile)
+  };
+}
+function validateSnapshot(snapshotPath) {
   if (!existsSync2(snapshotPath)) {
+    return { valid: false, error: `Snapshot path not found: ${snapshotPath}` };
+  }
+  const { layout, snapshotRuntime, snapshotSkills } = getSnapshotPaths(snapshotPath);
+  if (!existsSync2(snapshotRuntime) && !existsSync2(snapshotSkills)) {
     return {
-      success: false,
-      message: i18n.t("cli.init.failed"),
-      errors: [`Snapshot path not found: ${snapshotPath}`]
+      valid: false,
+      error: `Invalid snapshot: missing ${layout.rootDir}/ or ${getComponentPath("skills")} in ${snapshotPath}`
     };
   }
-  const layout = getProviderLayout();
-  const snapshotClaude = join10(snapshotPath, layout.rootDir);
-  if (!existsSync2(snapshotClaude)) {
+  return { valid: true };
+}
+async function backupExistingInstallationForSnapshot(targetDir, snapshotPath) {
+  const { layout } = getSnapshotPaths(snapshotPath);
+  const exists2 = await checkExistingInstallation(targetDir);
+  if (!exists2)
+    return;
+  console.log(i18n.t("cli.init.exists", { rootDir: layout.rootDir }));
+  console.log(i18n.t("cli.init.backing_up"));
+  const backupDir = join10(targetDir, `${layout.backupDirPrefix}${new Date().toISOString().replace(/[:.]/g, "-").slice(0, -1)}`);
+  if (existsSync2(join10(targetDir, layout.rootDir))) {
+    await cp(join10(targetDir, layout.rootDir), join10(backupDir, layout.rootDir), { recursive: true });
+  }
+  if (existsSync2(join10(targetDir, ".agents"))) {
+    await cp(join10(targetDir, ".agents"), join10(backupDir, ".agents"), { recursive: true });
+  }
+  if (existsSync2(join10(targetDir, layout.entryFile))) {
+    await copyFile2(join10(targetDir, layout.entryFile), join10(backupDir, layout.entryFile));
+  }
+  if (existsSync2(join10(targetDir, "guides"))) {
+    await cp(join10(targetDir, "guides"), join10(backupDir, "guides"), { recursive: true });
+  }
+  console.log(`  Backed up to: ${backupDir}`);
+}
+async function copySnapshotIntoTarget(targetDir, snapshotPath) {
+  const { layout, snapshotRuntime, snapshotSkills, snapshotGuides, snapshotEntry } = getSnapshotPaths(snapshotPath);
+  if (existsSync2(snapshotRuntime)) {
+    await cp(snapshotRuntime, join10(targetDir, layout.rootDir), {
+      recursive: true,
+      force: true
+    });
+  }
+  if (existsSync2(snapshotSkills)) {
+    await cp(snapshotSkills, join10(targetDir, getComponentPath("skills")), {
+      recursive: true,
+      force: true
+    });
+  }
+  if (existsSync2(snapshotGuides)) {
+    await cp(snapshotGuides, join10(targetDir, "guides"), {
+      recursive: true,
+      force: true
+    });
+  }
+  if (existsSync2(snapshotEntry)) {
+    await copyFile2(snapshotEntry, join10(targetDir, layout.entryFile));
+  }
+}
+async function installFromSnapshot(targetDir, snapshotPath, options) {
+  const snapshotValidation = validateSnapshot(snapshotPath);
+  if (!snapshotValidation.valid) {
     return {
       success: false,
       message: i18n.t("cli.init.failed"),
-      errors: [`Invalid snapshot: missing ${layout.rootDir}/ directory in ${snapshotPath}`]
+      errors: [snapshotValidation.error]
     };
   }
   console.log(`Installing from snapshot: ${snapshotPath}`);
   try {
-    const exists2 = await checkExistingInstallation(targetDir);
-    if (exists2 && !options.force) {
-      console.log(i18n.t("cli.init.exists", { rootDir: layout.rootDir }));
-      console.log(i18n.t("cli.init.backing_up"));
-      const backupDir = join10(targetDir, `${layout.backupDirPrefix}${new Date().toISOString().replace(/[:.]/g, "-").slice(0, -1)}`);
-      await cp(join10(targetDir, layout.rootDir), backupDir, { recursive: true });
-      console.log(`  Backed up to: ${backupDir}`);
-    }
-    await cp(snapshotClaude, join10(targetDir, layout.rootDir), {
-      recursive: true,
-      force: true
-    });
-    const snapshotGuides = join10(snapshotPath, "guides");
-    if (existsSync2(snapshotGuides)) {
-      await cp(snapshotGuides, join10(targetDir, "guides"), {
-        recursive: true,
-        force: true
-      });
-    }
-    const snapshotEntry = join10(snapshotPath, layout.entryFile);
-    if (existsSync2(snapshotEntry)) {
-      await copyFile2(snapshotEntry, join10(targetDir, layout.entryFile));
+    if (!options.force) {
+      await backupExistingInstallationForSnapshot(targetDir, snapshotPath);
     }
+    await copySnapshotIntoTarget(targetDir, snapshotPath);
     try {
       const existing = await readLockFile(targetDir);
       await writeLockFile(targetDir, package_default.version, existing);
@@ -29700,8 +29803,16 @@ async function runInitWizard(options) {
 // src/cli/init.ts
 async function checkExistingInstallation2(targetDir) {
   const layout = getProviderLayout();
-  const rootDir = join11(targetDir, layout.rootDir);
-  return fileExists(rootDir);
+  const markers = [layout.entryFile, layout.rootDir];
+  if (layout.provider === "codex") {
+    markers.push(".agents");
+  }
+  for (const marker of markers) {
+    if (await fileExists(join11(targetDir, marker))) {
+      return true;
+    }
+  }
+  return false;
 }
 var PROVIDER_SUBDIR_COMPONENTS = new Set([
   "rules",
@@ -29712,13 +29823,8 @@ var PROVIDER_SUBDIR_COMPONENTS = new Set([
   "ontology"
 ]);
 function componentToPath(targetDir, component) {
-  if (component === "entry-md") {
-    const layout = getProviderLayout();
-    return join11(targetDir, layout.entryFile);
-  }
-  if (PROVIDER_SUBDIR_COMPONENTS.has(component)) {
-    const layout = getProviderLayout();
-    return join11(targetDir, layout.rootDir, component);
+  if (component === "entry-md" || PROVIDER_SUBDIR_COMPONENTS.has(component)) {
+    return join11(targetDir, getComponentPath(component));
   }
   return join11(targetDir, component);
 }
@@ -29845,7 +29951,7 @@ async function initCommand(options) {
 }
 
 // src/cli/list.ts
-import { basename as basename5, dirname as dirname3, join as join12, relative as relative3 } from "node:path";
+import { basename as basename6, dirname as dirname3, join as join12, relative as relative3 } from "node:path";
 init_layout();
 init_fs();
 var ALLOWED_TOP_LEVEL_KEYS = new Set(["name", "type", "description", "version", "category"]);
@@ -29893,7 +29999,7 @@ function parseYamlMetadata(content) {
   return result;
 }
 function extractAgentTypeFromFilename(filename) {
-  const name = basename5(filename, ".md");
+  const name = basename6(filename, ".md");
   const prefixMap = {
     lang: "language",
     be: "backend",
@@ -29911,9 +30017,13 @@ function extractAgentTypeFromFilename(filename) {
   return prefixMap[prefix] || "unknown";
 }
 function extractSkillCategoryFromPath(skillPath, baseDir, rootDir) {
-  const relativePath = relative3(join12(baseDir, rootDir, "skills"), skillPath);
+  const provider = rootDir === ".claude" ? "claude" : "codex";
+  const relativePath = relative3(join12(baseDir, getComponentPath("skills", provider)), skillPath);
   const parts = relativePath.split("/").filter(Boolean);
-  return parts[0] || "unknown";
+  if (parts.length <= 1) {
+    return "general";
+  }
+  return parts[0];
 }
 function extractGuideCategoryFromPath(guidePath, baseDir) {
   const relativePath = relative3(join12(baseDir, "guides"), guidePath);
@@ -29921,7 +30031,7 @@ function extractGuideCategoryFromPath(guidePath, baseDir) {
   return parts[0] || "unknown";
 }
 function extractRulePriorityFromFilename(filename) {
-  const name = basename5(filename, ".md");
+  const name = basename6(filename, ".md");
   const parts = name.split("-");
   return parts[0] || "unknown";
 }
@@ -30019,8 +30129,8 @@ async function getAgents(targetDir, rootDir = ".codex", config) {
     const customAgentPaths = new Set(customComponents.filter((c) => c.type === "agent").map((c) => c.path));
     const agentMdFiles = await listFiles(agentsDir, { recursive: false, pattern: "*.md" });
     const agents = await Promise.all(agentMdFiles.map(async (agentMdPath) => {
-      const filename = basename5(agentMdPath);
-      const name = basename5(filename, ".md");
+      const filename = basename6(agentMdPath);
+      const name = basename6(filename, ".md");
       const description = await tryExtractMarkdownDescription(agentMdPath);
       const relativePath = relative3(targetDir, agentMdPath);
       return {
@@ -30038,7 +30148,8 @@ async function getAgents(targetDir, rootDir = ".codex", config) {
   }
 }
 async function getSkills(targetDir, rootDir = ".codex", config) {
-  const skillsDir = join12(targetDir, rootDir, "skills");
+  const provider = rootDir === ".claude" ? "claude" : "codex";
+  const skillsDir = join12(targetDir, getComponentPath("skills", provider));
   if (!await fileExists(skillsDir))
     return [];
   try {
@@ -30052,7 +30163,7 @@ async function getSkills(targetDir, rootDir = ".codex", config) {
       const { description, version } = await tryReadIndexYamlMetadata(indexYamlPath);
       const relativePath = relative3(targetDir, skillDir);
       return {
-        name: basename5(skillDir),
+        name: basename6(skillDir),
         type: "skill",
         category: extractSkillCategoryFromPath(skillDir, targetDir, rootDir),
         path: relativePath,
@@ -30079,7 +30190,7 @@ async function getGuides(targetDir, config) {
       const description = await tryExtractMarkdownDescription(guideMdPath, { maxLength: 100 });
       const relativePath = relative3(targetDir, guideMdPath);
       return {
-        name: basename5(guideMdPath, ".md"),
+        name: basename6(guideMdPath, ".md"),
         type: "guide",
         category: extractGuideCategoryFromPath(guideMdPath, targetDir),
         path: relativePath,
@@ -30103,13 +30214,13 @@ async function getRules(targetDir, rootDir = ".codex", config) {
     const customRulePaths = new Set(customComponents.filter((c) => c.type === "rule").map((c) => c.path));
     const ruleMdFiles = await listFiles(rulesDir, { recursive: false, pattern: "*.md" });
     const rules = await Promise.all(ruleMdFiles.map(async (ruleMdPath) => {
-      const filename = basename5(ruleMdPath);
+      const filename = basename6(ruleMdPath);
       const description = await tryExtractMarkdownDescription(ruleMdPath, {
         cleanFormatting: true
       });
       const relativePath = relative3(targetDir, ruleMdPath);
       return {
-        name: basename5(ruleMdPath, ".md"),
+        name: basename6(ruleMdPath, ".md"),
         type: extractRulePriorityFromFilename(filename),
         path: relativePath,
         description,
@@ -30175,7 +30286,7 @@ async function getHooks(targetDir, rootDir = ".codex") {
     const hookYamls = await listFiles(hooksDir, { recursive: true, pattern: "*.yaml" });
     const allFiles = [...hookFiles, ...hookConfigs, ...hookYamls];
     return allFiles.map((hookPath) => ({
-      name: basename5(hookPath),
+      name: basename6(hookPath),
       type: "hook",
       path: relative3(targetDir, hookPath)
     })).sort((a, b) => a.name.localeCompare(b.name));
@@ -30195,7 +30306,7 @@ async function getContexts(targetDir, rootDir = ".codex") {
       const ext = ctxPath.endsWith(".md") ? ".md" : ".yaml";
       const description = ext === ".md" ? await tryExtractMarkdownDescription(ctxPath, { maxLength: 100 }) : undefined;
       return {
-        name: basename5(ctxPath, ext),
+        name: basename6(ctxPath, ext),
         type: "context",
         path: relative3(targetDir, ctxPath),
         description
@@ -30883,6 +30994,7 @@ async function exportSnapshot(targetDir, outputPath) {
   const detection = await detectProvider({ targetDir });
   const layout = getProviderLayout(detection.provider);
   const runtimeDir = join16(targetDir, layout.rootDir);
+  const skillsDir = join16(targetDir, getComponentPath("skills", detection.provider));
   const guidesDir = join16(targetDir, "guides");
   if (!existsSync4(runtimeDir)) {
     return { success: false, exportPath: outputPath, fileCount: 0 };
@@ -30893,6 +31005,12 @@ async function exportSnapshot(targetDir, outputPath) {
     recursive: true,
     filter: isExportable
   });
+  if (existsSync4(skillsDir)) {
+    await cp2(skillsDir, join16(outputPath, getComponentPath("skills", detection.provider)), {
+      recursive: true,
+      filter: isExportable
+    });
+  }
   if (existsSync4(guidesDir)) {
     await cp2(guidesDir, join16(outputPath, "guides"), { recursive: true });
   }
@@ -30905,6 +31023,7 @@ async function exportSnapshot(targetDir, outputPath) {
 }
 
 // src/cli/sync.ts
+init_cli_command_name();
 async function runExport(targetDir, outputPath) {
   const result = await exportSnapshot(targetDir, resolve3(outputPath));
   const layout = getProviderLayout();
@@ -30915,7 +31034,7 @@ Export failed — no ${layout.rootDir}/ directory found in current project.`);
   }
   console.log(`
 Snapshot exported: ${result.exportPath} (${result.fileCount} files)`);
-  console.log(`Team members can install with: omcodex init --from-snapshot ${result.exportPath}`);
+  console.log(rewriteCliCommandReferences(`Team members can install with: omcodex init --from-snapshot ${result.exportPath}`));
 }
 function printDriftDetails(result) {
   if (result.unchanged > 0) {
@@ -30943,8 +31062,8 @@ function printDriftDetails(result) {
 async function runCheck(targetDir, options) {
   const result = await syncCheck(targetDir, { reference: options.reference });
   if (!result.referenceVersion) {
-    console.error(`
-No lockfile found. Run omcodex init first.`);
+    console.error(rewriteCliCommandReferences(`
+No lockfile found. Run omcodex init first.`));
     process.exit(1);
   }
   const label = options.reference ? `external snapshot at ${options.reference}` : `lockfile (v${result.referenceVersion})`;
@@ -31733,6 +31852,9 @@ function getComponentPath2(component) {
   if (component === "guides") {
     return "guides";
   }
+  if (layout.provider === "codex" && component === "skills") {
+    return ".agents/skills";
+  }
   return `${layout.rootDir}/${component}`;
 }
 async function backupInstallation(targetDir) {
@@ -31742,6 +31864,9 @@ async function backupInstallation(targetDir) {
   await ensureDirectory(backupDir);
   const layout = getProviderLayout();
   const dirsToBackup = [layout.rootDir, "guides"];
+  if (layout.provider === "codex") {
+    dirsToBackup.push(".agents");
+  }
   for (const dir2 of dirsToBackup) {
     const srcPath = join17(targetDir, dir2);
     if (await fileExists(srcPath)) {
@@ -32057,9 +32182,9 @@ async function webOpenCommand(options) {
 // src/cli/index.ts
 var require2 = createRequire2(import.meta.url);
 var packageJson = require2("../../package.json");
-function createProgram() {
+function createProgram(commandName = getActiveCliCommandName()) {
   const program2 = new Command;
-  program2.name("omcodex").description(i18n.t("cli.description")).version(packageJson.version, "-v, --version", i18n.t("cli.versionOption")).option("--skip-version-check", "Skip CLI version pre-flight check");
+  program2.name(commandName).description(i18n.t("cli.description")).version(packageJson.version, "-v, --version", i18n.t("cli.versionOption")).option("--skip-version-check", "Skip CLI version pre-flight check");
   program2.command("init").description(i18n.t("cli.init.description")).option("-l, --lang <language>", i18n.t("cli.init.langOption")).option("--domain <domain>", "Install only agents/skills for specific domain (backend, frontend, data-engineering, devops)").option("--yes", "Skip interactive wizard, use defaults").option("--from-snapshot <path>", "Install from a pre-configured team snapshot directory").action(async (options) => {
     await initCommand(options);
   });
@@ -32096,11 +32221,11 @@ function createProgram() {
   web.action(async () => {
     await webStatusCommand();
   });
-  program2.command("serve").description("(Deprecated) Start the Web UI server — use `omcodex web start` instead").option("-p, --port <port>", i18n.t("cli.web.start.portOption"), "4321").option("--foreground", i18n.t("cli.web.start.foregroundOption")).action(async (options) => {
+  program2.command("serve").description(`(Deprecated) Start the Web UI server — use \`${commandName} web start\` instead`).option("-p, --port <port>", i18n.t("cli.web.start.portOption"), "4321").option("--foreground", i18n.t("cli.web.start.foregroundOption")).action(async (options) => {
     console.warn(i18n.t("cli.web.deprecated.serve"));
     await serveCommand(options);
   });
-  program2.command("serve-stop").description("(Deprecated) Stop the Web UI server — use `omcodex web stop` instead").action(async () => {
+  program2.command("serve-stop").description(`(Deprecated) Stop the Web UI server — use \`${commandName} web stop\` instead`).action(async () => {
     console.warn(i18n.t("cli.web.deprecated.serveStop"));
     await serveStopCommand();
   });
@@ -32149,15 +32274,29 @@ function createProgram() {
   return program2;
 }
 async function main() {
+  setActiveCliCommandName(detectCliCommandName());
   const lang = detectLanguage();
   await initI18n(lang);
   const program2 = createProgram();
   await program2.parseAsync(process.argv);
 }
-main().catch((error2) => {
-  console.error(i18n.t("cli.error.unexpected"), error2);
-  process.exit(1);
-});
+function isDirectExecution() {
+  const argvPath = process.argv[1];
+  if (!argvPath) {
+    return false;
+  }
+  try {
+    return realpathSync(argvPath) === realpathSync(fileURLToPath3(import.meta.url));
+  } catch {
+    return resolve4(argvPath) === resolve4(fileURLToPath3(import.meta.url));
+  }
+}
+if (isDirectExecution()) {
+  main().catch((error2) => {
+    console.error(i18n.t("cli.error.unexpected"), error2);
+    process.exit(1);
+  });
+}
 export {
   main,
   createProgram

package/dist/index.js

@@ -538,6 +538,9 @@ function getComponentPath(component, provider = "codex") {
   if (component === "guides") {
     return "guides";
   }
+  if (provider === "codex" && component === "skills") {
+    return ".agents/skills";
+  }
   return `${layout.rootDir}/${component}`;
 }
 function getTemplateComponentPath(component, provider = "codex") {
@@ -566,8 +569,9 @@ var init_layout = __esm(() => {
       ".codex/hooks",
       ".codex/contexts",
       ".codex/agents",
-      ".codex/skills",
       ".codex/ontology",
+      ".agents",
+      ".agents/skills",
       "guides"
     ]
   };
@@ -2084,6 +2088,9 @@ async function backupExisting(sourcePath, backupDir) {
 async function checkExistingPaths(targetDir) {
   const layout = getProviderLayout();
   const pathsToCheck = [layout.entryFile, layout.rootDir, "guides"];
+  if (layout.provider === "codex") {
+    pathsToCheck.push(".agents");
+  }
   const existingPaths = [];
   for (const relativePath of pathsToCheck) {
     const fullPath = join5(targetDir, relativePath);
@@ -2173,12 +2180,14 @@ var package_default = {
   workspaces: [
     "packages/*"
   ],
-  version: "0.2.0",
+  version: "0.3.0",
   description: "Batteries-included agent harness on top of GPT Codex + OMX",
   type: "module",
   bin: {
     omcodex: "./dist/cli/index.js",
-    omcustom: "./dist/cli/index.js"
+    omcustom: "./dist/cli/index.js",
+    omcustomx: "./dist/cli/index.js",
+    omcustomcodex: "./dist/cli/index.js"
   },
   main: "./dist/index.js",
   types: "./dist/index.d.ts",
@@ -4669,12 +4678,32 @@ var setDefaultNamespace = instance.setDefaultNamespace;
 var hasLoadedNamespace = instance.hasLoadedNamespace;
 var loadNamespaces = instance.loadNamespaces;
 var loadLanguages = instance.loadLanguages;
+
+// src/utils/cli-command-name.ts
+var DEFAULT_CLI_COMMAND = "omcodex";
+var KNOWN_CLI_COMMANDS = new Set([DEFAULT_CLI_COMMAND, "omcustom", "omcustomx", "omcustomcodex"]);
+var WINDOWS_SCRIPT_EXTENSIONS = /\.(cmd|exe|ps1|bat)$/i;
+var activeCliCommandName = DEFAULT_CLI_COMMAND;
+function normalizeCliCommandName(commandName) {
+  const normalized = commandName?.trim().toLowerCase().replace(WINDOWS_SCRIPT_EXTENSIONS, "");
+  return normalized && KNOWN_CLI_COMMANDS.has(normalized) ? normalized : DEFAULT_CLI_COMMAND;
+}
+function getActiveCliCommandName() {
+  return activeCliCommandName;
+}
+function rewriteCliCommandReferences(text, commandName = getActiveCliCommandName()) {
+  const normalizedCommandName = normalizeCliCommandName(commandName);
+  if (normalizedCommandName === DEFAULT_CLI_COMMAND) {
+    return text;
+  }
+  return text.replace(/(^|[^A-Za-z0-9_.-])omcodex(?=$|[^A-Za-z0-9_.-])/g, (_match, prefix) => `${prefix}${normalizedCommandName}`);
+}
 // src/i18n/types.ts
 var DEFAULT_LANGUAGE2 = "en";
 // src/i18n/index.ts
 var i18n = {
   t(key, options) {
-    return instance.t(key, options);
+    return rewriteCliCommandReferences(instance.t(key, options));
   },
   async changeLanguage(language) {
     await instance.changeLanguage(language);
@@ -5458,6 +5487,9 @@ function getComponentPath2(component) {
   if (component === "guides") {
     return "guides";
   }
+  if (layout.provider === "codex" && component === "skills") {
+    return ".agents/skills";
+  }
   return `${layout.rootDir}/${component}`;
 }
 async function backupInstallation(targetDir) {
@@ -5467,6 +5499,9 @@ async function backupInstallation(targetDir) {
   await ensureDirectory(backupDir);
   const layout = getProviderLayout();
   const dirsToBackup = [layout.rootDir, "guides"];
+  if (layout.provider === "codex") {
+    dirsToBackup.push(".agents");
+  }
   for (const dir2 of dirsToBackup) {
     const srcPath = join8(targetDir, dir2);
     if (await fileExists(srcPath)) {

package/package.json

@@ -3,12 +3,14 @@
   "workspaces": [
     "packages/*"
   ],
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Batteries-included agent harness on top of GPT Codex + OMX",
   "type": "module",
   "bin": {
     "omcodex": "./dist/cli/index.js",
-    "omcustom": "./dist/cli/index.js"
+    "omcustom": "./dist/cli/index.js",
+    "omcustomx": "./dist/cli/index.js",
+    "omcustomcodex": "./dist/cli/index.js"
   },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/templates/.claude/hooks/hooks.json

@@ -105,6 +105,10 @@
       {
         "matcher": "tool == \"Task\" || tool == \"Agent\"",
         "hooks": [
+          {
+            "type": "command",
+            "command": "bash .codex/hooks/scripts/agent-mode-guard.sh"
+          },
           {
             "type": "command",
             "command": "#!/bin/bash\ninput=$(cat)\nagent_type=$(echo \"$input\" | jq -r '.tool_input.subagent_type // \"unknown\"')\nmodel=$(echo \"$input\" | jq -r '.tool_input.model // \"inherit\"')\ndesc=$(echo \"$input\" | jq -r '.tool_input.description // \"\"' | head -c 40)\nresume=$(echo \"$input\" | jq -r '.tool_input.resume // empty')\nif [ -n \"$resume\" ]; then\n  echo \"─── [Resume] ${agent_type}:${model} | ${desc} ───\" >&2\nelse\n  echo \"─── [Spawn] ${agent_type}:${model} | ${desc} ───\" >&2\nfi\necho \"$input\""

package/templates/.claude/hooks/scripts/agent-mode-guard.sh

@@ -0,0 +1,22 @@
+#!/bin/bash
+# Agent mode guard
+# Blocks Agent/Task spawns that omit mode:"bypassPermissions".
+# This closes the gap where frontmatter permissionMode is ignored unless the
+# spawn call sets mode explicitly.
+
+set -euo pipefail
+
+command -v jq >/dev/null 2>&1 || exit 0
+
+input=$(cat)
+mode=$(echo "$input" | jq -r '.tool_input.mode // ""')
+
+if [ "$mode" != "bypassPermissions" ]; then
+  echo "[Hook] BLOCKED: Agent/Task spawn missing required mode: \"bypassPermissions\"" >&2
+  echo "[Hook] Saw mode: ${mode:-<missing>}" >&2
+  echo "[Hook] The Agent tool defaults to acceptEdits and will trigger permission prompts." >&2
+  echo "[Hook] Fix the spawn call by adding: mode: \"bypassPermissions\"" >&2
+  exit 2
+fi
+
+echo "$input"

package/templates/CLAUDE.md

@@ -115,11 +115,12 @@ project/
 +-- AGENTS.md                    # 진입점
 +-- .codex/
 |   +-- agents/                  # 서브에이전트 정의 (48 파일)
-|   +-- skills/                  # 스킬 (109 디렉토리)
 |   +-- rules/                   # 전역 규칙 (R000-R022)
 |   +-- hooks/                   # 훅 스크립트 (보안, 검증, HUD)
 |   +-- contexts/                # 컨텍스트 파일 (ecomode)
-+-- guides/                      # 레퍼런스 문서 (38 토픽)
++-- .agents/
+|   +-- skills/                  # 스킬 (109 디렉토리)
++-- guides/                      # 레퍼런스 문서 (39 토픽)
 ```
 
 ## 오케스트레이션
@@ -149,7 +150,7 @@ oh-my-customcodex는 소프트웨어 컴파일과 동일한 구조를 따릅니
 
 | 컴파일 개념 | oh-my-customcodex 매핑 | 역할 |
 |------------|----------------------|------|
-| Source code | `.codex/skills/` | 재사용 가능한 지식과 워크플로우 정의 |
+| Source code | `.agents/skills/` | 재사용 가능한 지식과 워크플로우 정의 |
 | Build artifacts | `.codex/agents/` | 스킬을 조합한 실행 가능한 전문가 |
 | Compiler | `mgr-sauron` (R017) | 구조 검증 및 정합성 보장 |
 | Spec | `.codex/rules/` | 빌드 규칙과 제약 조건 |

package/templates/CLAUDE.md.en

@@ -136,7 +136,7 @@ project/
 |   +-- rules/                   # Global rules (22 files)
 |   +-- hooks/                   # Hook scripts (security, validation, HUD)
 |   +-- contexts/                # Context files (4 files)
-+-- guides/                      # Reference docs (38 topics)
++-- guides/                      # Reference docs (39 topics)
 ```
 
 ## Orchestration

package/templates/CLAUDE.md.ko

@@ -136,7 +136,7 @@ project/
 |   +-- rules/                   # 전역 규칙 (22 파일)
 |   +-- hooks/                   # 훅 스크립트 (보안, 검증, HUD)
 |   +-- contexts/                # 컨텍스트 파일 (4 파일)
-+-- guides/                      # 레퍼런스 문서 (38 토픽)
++-- guides/                      # 레퍼런스 문서 (39 토픽)
 ```
 
 ## 오케스트레이션

package/templates/guides/browser-automation/README.md

@@ -106,8 +106,8 @@ That keeps visual comparisons honest and makes "taste memory" reusable.
 
 ## Related Surfaces
 
-- `.codex/skills/product-strategy/SKILL.md`
-- `.codex/skills/design-shotgun/SKILL.md`
-- `.codex/skills/playwright-compress/SKILL.md`
+- `.agents/skills/product-strategy/SKILL.md`
+- `.agents/skills/design-shotgun/SKILL.md`
+- `.agents/skills/playwright-compress/SKILL.md`
 - `guides/web-scraping/README.md`
 - `packages/serve/playwright.config.ts`

package/templates/guides/index.yaml

@@ -57,6 +57,14 @@ guides:
       origin: docs.oracle.com
       url: https://docs.oracle.com/en/java/javase/21/
 
+  - name: java
+    description: Java 25 LTS language reference and modern feature documentation
+    path: ./java/
+    source:
+      type: external
+      origin: docs.oracle.com
+      url: https://docs.oracle.com/en/java/javase/25/
+
   - name: python
     description: Python reference from PEP 8 and PEP 20
     path: ./python/

package/templates/guides/java/index.yaml

@@ -0,0 +1,29 @@
+# Java Guide
+
+metadata:
+  name: java
+  description: Java 25 LTS language reference and modern feature documentation
+
+source:
+  type: external
+  origin: docs.oracle.com
+  urls:
+    - https://docs.oracle.com/en/java/javase/25/
+    - https://openjdk.org/projects/loom/
+    - https://openjdk.org/jeps/440
+    - https://openjdk.org/jeps/441
+    - https://openjdk.org/jeps/444
+    - https://google.github.io/styleguide/javaguide.html
+  last_fetched: "2026-04-20"
+
+documents:
+  - name: modern-java
+    path: ./modern-java.md
+    description: Java 25 LTS modern features (Virtual Threads, Pattern Matching, Records, Sealed Classes)
+
+  - name: java-style-guide
+    path: ./java-style-guide.md
+    description: Google Java Style Guide conventions
+
+used_by:
+  - lang-java-expert

package/templates/guides/java/java-style-guide.md

@@ -0,0 +1,35 @@
+# Google Java Style Guide Notes
+
+> Source: https://google.github.io/styleguide/javaguide.html
+
+## Core Conventions
+
+- Indent with 2 spaces, never tabs
+- Use `UpperCamelCase` for classes, `lowerCamelCase` for methods and fields
+- Constants use `UPPER_SNAKE_CASE`
+- Prefer one top-level type per file
+- Keep line length readable and wrap before expressions become visually dense
+
+## Imports
+
+- No wildcard imports
+- Static imports come before non-static imports
+- Keep imports sorted ASCII-style within each block
+
+## Braces
+
+- Opening brace stays on the same line
+- Always use braces for `if`, `for`, `while`, and `do`
+
+## Classes And Members
+
+- Order members consistently: constants, fields, constructors, public methods, private helpers
+- Prefer immutable fields where possible
+- Document non-obvious public API behavior with Javadoc
+
+## Naming
+
+- Packages: lowercase, no underscores
+- Types: nouns or noun phrases
+- Methods: verbs or verb phrases
+- Test methods: describe behavior, not implementation detail

package/templates/guides/java/modern-java.md

@@ -0,0 +1,71 @@
+# Modern Java Features
+
+> Sources: https://openjdk.org/jeps/ (JEP 431, 440, 441, 444)
+
+## Virtual Threads (JEP 444)
+
+Virtual Threads are lightweight threads managed by the JVM, enabling millions of concurrent tasks without thread pool tuning.
+
+### Key Properties
+
+| Property | Platform Thread | Virtual Thread |
+|----------|----------------|----------------|
+| Creation cost | High (OS thread) | Low (JVM-managed) |
+| Memory footprint | ~1MB per thread | ~few KB |
+| Blocking behavior | Blocks OS thread | Unmounts carrier thread |
+| Pooling | Needed | Not recommended |
+
+### Usage
+
+```java
+try (var executor = Executors.newVirtualThreadPerTaskExecutor()) {
+    List<Future<String>> futures = IntStream.range(0, 10_000)
+        .mapToObj(i -> executor.submit(() -> fetchData(i)))
+        .toList();
+}
+
+Thread.ofVirtual().name("vt-worker").start(() -> processRequest());
+```
+
+## Pattern Matching
+
+```java
+if (obj instanceof String s && !s.isEmpty()) {
+    return s.toUpperCase();
+}
+
+String format = switch (obj) {
+    case Integer i -> "int %d".formatted(i);
+    case String s -> "string %s".formatted(s);
+    case null -> "null";
+    default -> obj.toString();
+};
+```
+
+## Records
+
+```java
+record Point(int x, int y) {}
+
+record Range(int min, int max) {
+    Range {
+        if (min > max) {
+            throw new IllegalArgumentException("min > max");
+        }
+    }
+}
+```
+
+## Sealed Types
+
+```java
+sealed interface Shape permits Circle, Rectangle {}
+
+record Circle(double radius) implements Shape {}
+record Rectangle(double width, double height) implements Shape {}
+```
+
+## Sequenced Collections
+
+- Prefer `getFirst()` / `getLast()` over index arithmetic for ordered collections
+- Use `reversed()` when reverse traversal is the intent

package/templates/manifest.json

@@ -1,6 +1,6 @@
 {
-  "version": "0.2.0",
-  "lastUpdated": "2026-04-19T08:50:00.000Z",
+  "version": "0.3.0",
+  "lastUpdated": "2026-04-20T06:05:00.000Z",
   "components": [
     {
       "name": "rules",
@@ -16,15 +16,15 @@
     },
     {
       "name": "skills",
-      "path": ".codex/skills",
-      "description": "Reusable skill modules (includes slash commands)",
+      "path": ".agents/skills",
+      "description": "Reusable skill modules (project-scoped repo skills)",
       "files": 112
     },
     {
       "name": "guides",
       "path": "guides",
       "description": "Reference documentation",
-      "files": 39
+      "files": 40
     },
     {
       "name": "hooks",