Merge branch 'master' into fix/codex-session-management

修复 Codex CLI 子进程提前退出时 stdin BrokenPipe 导致未采集真实退出码的问题。\n\n- BrokenPipe 时继续等待并采集脱敏 stderr\n- 非零退出优先返回真实退出码\n- 保留其他 stdin 错误的快速失败行为\n\n已验证：Codex CLI 失败回归测试、cargo fmt、编码检查、git diff --check。

Reviewed-on: http://192.168.35.82/git/GenarrativeAI/Genarrative/pulls/273
Co-authored-by: kdletters <kdletters@qq.com>
Co-committed-by: kdletters <kdletters@qq.com>

.cloudbase/container/debug.json

@@ -1 +1 @@
-{"containers":[],"config":{}}
+{ "containers": [], "config": {} }

.codex/README.md

@@ -0,0 +1,16 @@
+# Genarrative Codex 项目工具
+
+`.codex/` 是仓库级 Codex 工具目录，保存项目共享的 skills、插件资源、hooks 和相关配置模板。它只描述如何协作和加载工具，不承载项目业务知识。
+
+## 目录约定
+
+- `.codex/skills/` 是项目专属 skill 根目录。每个 skill 以目录中的 `SKILL.md` 为入口，配套的参考资料和脚本放在同一目录下。
+- `.codex/plugins/` 保存随仓库分发的项目插件资源及其参考资料。当前的 `game-studio` 插件提供浏览器游戏设计、原型、2D/3D 技术栈、素材管线和 playtest 工作流；是否启用遵循当前 Codex 的插件加载机制，不依赖旧工具的环境变量或个人配置脚本。
+- `.codex/hooks/`、`.codex/environments/` 等目录保存项目工具链所需的 hooks 和环境模板；它们不替代项目代码中的运行时配置。
+- 长期有效的产品、架构、接口、排障和协作知识统一放在 `docs/` 与 `docs/project-memory/`，不复制到本目录。
+
+## 使用边界
+
+进入仓库后先读根目录 `AGENTS.md`，再按任务路由读取对应 skill。SpacetimeDB 的通用概念、Rust 服务端、CLI、TypeScript 客户端和 MCP 用法由已安装的官方插件提供；项目约束和入口由 `.codex/skills/genarrative-spacetimedb/SKILL.md` 统一编排。
+
+个人 `~/.codex` 配置、凭据、会话、环境变量和本地路径不得复制到仓库。若本目录内容与当前代码或最新 `docs/` 冲突，以代码和最新文档为准，并修正过期工具说明。

.codex/hooks/post-edit-codegraph-sync.mjs

@@ -7,23 +7,33 @@ import { fileURLToPath } from 'node:url';
 const scriptDir = dirname(fileURLToPath(import.meta.url));
 const repoRoot = resolve(scriptDir, '..', '..');
 const logDir = resolve(repoRoot, '.codex', 'logs');
-const hasCodegraphConfig = existsSync(resolve(repoRoot, '.codegraph', 'config.json'));
+const hasCodegraphConfig = existsSync(
+  resolve(repoRoot, '.codegraph', 'config.json'),
+);
 const npmCommand = process.platform === 'win32' ? 'cmd' : 'npm';
 
 if (!hasCodegraphConfig) {
-  console.log('[codex-hook] 未发现 .codegraph/config.json，跳过 CodeGraph 同步。');
+  console.log(
+    '[codex-hook] 未发现 .codegraph/config.json，跳过 CodeGraph 同步。',
+  );
   process.exit(0);
 }
 
-const result = spawnSync(npmCommand, process.platform === 'win32' ? ['/d', '/s', '/c', 'npm run codegraph:sync'] : ['run', 'codegraph:sync'], {
-  cwd: repoRoot,
-  shell: false,
-  encoding: 'utf8',
-  env: {
-    ...process.env,
-    NO_COLOR: process.env.NO_COLOR ?? '1',
+const result = spawnSync(
+  npmCommand,
+  process.platform === 'win32'
+    ? ['/d', '/s', '/c', 'npm run codegraph:sync']
+    : ['run', 'codegraph:sync'],
+  {
+    cwd: repoRoot,
+    shell: false,
+    encoding: 'utf8',
+    env: {
+      ...process.env,
+      NO_COLOR: process.env.NO_COLOR ?? '1',
+    },
   },
-});
+);
 
 mkdirSync(logDir, { recursive: true });
 if (result.stdout) {
@@ -44,7 +54,9 @@ if (result.signal) {
 }
 
 if ((result.status ?? 0) !== 0) {
-  console.error('[codex-hook] CodeGraph 同步失败，请手动运行 npm run codegraph:sync 查看详情。');
+  console.error(
+    '[codex-hook] CodeGraph 同步失败，请手动运行 npm run codegraph:sync 查看详情。',
+  );
   process.exit(result.status ?? 1);
 }
 

.codex/plugins/game-studio/.codex-plugin/plugin.json

@@ -0,0 +1,41 @@
+{
+  "name": "game-studio",
+  "version": "0.1.0",
+  "description": "Design, prototype, and ship browser games with guided 2D and 3D workflows, asset pipelines, and playtesting support.",
+  "author": {
+    "name": "OpenAI",
+    "email": "support@openai.com",
+    "url": "https://openai.com/"
+  },
+  "homepage": "https://openai.com/",
+  "repository": "https://github.com/openai/plugins",
+  "license": "MIT",
+  "keywords": [
+    "games",
+    "phaser",
+    "threejs",
+    "react-three-fiber",
+    "gltf",
+    "rapier",
+    "webgl",
+    "sprites",
+    "playtest"
+  ],
+  "skills": "./skills/",
+  "interface": {
+    "displayName": "Game Studio",
+    "shortDescription": "Design, prototype, and ship browser games",
+    "longDescription": "Plan, prototype, and build browser games with guided workflows for gameplay systems, UI, asset pipelines, and playtesting across 2D and 3D projects.",
+    "developerName": "OpenAI",
+    "category": "Coding",
+    "capabilities": ["Interactive", "Write"],
+    "websiteURL": "https://openai.com/",
+    "privacyPolicyURL": "https://openai.com/policies/privacy-policy/",
+    "termsOfServiceURL": "https://openai.com/policies/terms-of-use/",
+    "defaultPrompt": ["Design a browser game and plan the core loop"],
+    "brandColor": "#0F766E",
+    "composerIcon": "./assets/game-studio.svg",
+    "logo": "./assets/app-icon.png",
+    "screenshots": []
+  }
+}

.codex/plugins/game-studio/__init__.py

@@ -1,8 +1,8 @@
-"""Hermes wrapper for the OpenAI Codex Game Studio plugin.
+"""Metadata bridge for the bundled Codex Game Studio project plugin.
 
-This plugin was imported from a Codex curated plugin cache. It exposes the
-plugin's bundled SKILL.md files as Hermes plugin skills using qualified names
-like `game-studio:phaser-2d-game`.
+The manifest and bundled ``SKILL.md`` files are the source of truth. This
+module only exposes their descriptions to a compatible plugin host and keeps
+the project resource bundle free of runtime-specific behavior.
 """
 
 from __future__ import annotations

.codex/plugins/game-studio/plugin.yaml

@@ -0,0 +1,7 @@
+name: game-studio
+version: 0.1.0
+description:
+  Design, prototype, and ship browser games with guided 2D and 3D workflows,
+  asset pipelines, and playtesting support.
+author: OpenAI
+kind: standalone

.codex/plugins/game-studio/references/gltf-loading-starter.md

@@ -0,0 +1,43 @@
+# GLB Loading Starter
+
+Use this as the canonical minimal pattern for loading shipped 3D content.
+
+## Vanilla Three.js
+
+```ts
+import { GLTFLoader } from 'three/examples/jsm/loaders/GLTFLoader.js';
+import { DRACOLoader } from 'three/examples/jsm/loaders/DRACOLoader.js';
+
+const draco = new DRACOLoader();
+draco.setDecoderPath('/draco/');
+
+const gltfLoader = new GLTFLoader();
+gltfLoader.setDRACOLoader(draco);
+
+gltfLoader.load('/assets/hero.glb', (gltf) => {
+  const root = gltf.scene;
+  root.traverse((node) => {
+    if ('castShadow' in node) {
+      node.castShadow = true;
+      node.receiveShadow = true;
+    }
+  });
+  scene.add(root);
+});
+```
+
+## React Three Fiber
+
+```tsx
+import { useGLTF } from '@react-three/drei';
+
+function HeroModel() {
+  const gltf = useGLTF('/assets/hero.glb');
+  return <primitive object={gltf.scene} />;
+}
+```
+
+## Notes
+
+- Default shipping format is GLB or glTF 2.0.
+- Keep optimization upstream in the asset pipeline; loader code should stay boring.

.codex/plugins/game-studio/references/rapier-integration-starter.md

@@ -5,12 +5,14 @@ Use this as the smallest canonical pattern for adding physics without letting it
 ## Vanilla Three.js
 
 ```ts
-import RAPIER from "@dimforge/rapier3d-compat";
+import RAPIER from '@dimforge/rapier3d-compat';
 
 await RAPIER.init();
 
 const world = new RAPIER.World({ x: 0, y: -9.81, z: 0 });
-const body = world.createRigidBody(RAPIER.RigidBodyDesc.dynamic().setTranslation(0, 2, 0));
+const body = world.createRigidBody(
+  RAPIER.RigidBodyDesc.dynamic().setTranslation(0, 2, 0),
+);
 world.createCollider(RAPIER.ColliderDesc.cuboid(0.5, 0.5, 0.5), body);
 
 renderer.setAnimationLoop(() => {
@@ -24,7 +26,7 @@ renderer.setAnimationLoop(() => {
 ## React Three Fiber
 
 ```tsx
-import { Physics, RigidBody } from "@react-three/rapier";
+import { Physics, RigidBody } from '@react-three/rapier';
 
 <Physics gravity={[0, -9.81, 0]}>
   <RigidBody colliders="cuboid">

.codex/plugins/game-studio/references/react-three-fiber-starter.md

@@ -12,7 +12,7 @@ src/
 ## `src/App.tsx`
 
 ```tsx
-import { Canvas } from "@react-three/fiber";
+import { Canvas } from '@react-three/fiber';
 
 function Spinner() {
   return (
@@ -27,7 +27,7 @@ export default function App() {
   return (
     <div className="app-shell">
       <Canvas camera={{ position: [0, 1.5, 4], fov: 60 }}>
-        <color attach="background" args={["#101418"]} />
+        <color attach="background" args={['#101418']} />
         <ambientLight intensity={0.7} />
         <directionalLight position={[4, 6, 3]} intensity={1.2} />
         <Spinner />

.codex/plugins/game-studio/references/threejs-vanilla-starter.md

@@ -12,12 +12,17 @@ src/
 ## `src/main.ts`
 
 ```ts
-import * as THREE from "three";
+import * as THREE from 'three';
 
 const scene = new THREE.Scene();
-scene.background = new THREE.Color("#101418");
+scene.background = new THREE.Color('#101418');
 
-const camera = new THREE.PerspectiveCamera(60, window.innerWidth / window.innerHeight, 0.1, 200);
+const camera = new THREE.PerspectiveCamera(
+  60,
+  window.innerWidth / window.innerHeight,
+  0.1,
+  200,
+);
 camera.position.set(0, 1.5, 4);
 
 const renderer = new THREE.WebGLRenderer({ antialias: true });
@@ -32,11 +37,11 @@ scene.add(light);
 
 const mesh = new THREE.Mesh(
   new THREE.BoxGeometry(1, 1, 1),
-  new THREE.MeshStandardMaterial({ color: "#3dd9b8" }),
+  new THREE.MeshStandardMaterial({ color: '#3dd9b8' }),
 );
 scene.add(mesh);
 
-window.addEventListener("resize", () => {
+window.addEventListener('resize', () => {
   camera.aspect = window.innerWidth / window.innerHeight;
   camera.updateProjectionMatrix();
   renderer.setSize(window.innerWidth, window.innerHeight);