oh-my-customcodex 0.2.0 → 0.2.1

package/README.md

@@ -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

@@ -3087,7 +3087,7 @@ var init_package = __esm(() => {
     workspaces: [
       "packages/*"
     ],
-    version: "0.2.0",
+    version: "0.2.1",
     description: "Batteries-included agent harness on top of GPT Codex + OMX",
     type: "module",
     bin: {

package/dist/index.js

@@ -2173,7 +2173,7 @@ var package_default = {
   workspaces: [
     "packages/*"
   ],
-  version: "0.2.0",
+  version: "0.2.1",
   description: "Batteries-included agent harness on top of GPT Codex + OMX",
   type: "module",
   bin: {

package/package.json

@@ -3,7 +3,7 @@
   "workspaces": [
     "packages/*"
   ],
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Batteries-included agent harness on top of GPT Codex + OMX",
   "type": "module",
   "bin": {

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

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

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/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,5 +1,5 @@
 {
-  "version": "0.2.0",
+  "version": "0.2.1",
   "lastUpdated": "2026-04-19T08:50:00.000Z",
   "components": [
     {
@@ -24,7 +24,7 @@
       "name": "guides",
       "path": "guides",
       "description": "Reference documentation",
-      "files": 39
+      "files": 40
     },
     {
       "name": "hooks",