@milenyumai/film-kit 1.4.1 → 1.4.3

package/README.md

@@ -1,8 +1,8 @@
 # Film-Kit
 
-Professional cinematic prompt-engineering kits for Claude Code, Cursor, GitHub Copilot, and Antigravity.
+Professional cinematic prompt-engineering kits for OpenAI Codex App, Claude Code, Cursor, GitHub Copilot, and Antigravity.
 
-Film-Kit ships as a single repository with four npm packages:
+Film-Kit ships as a single repository with five npm packages:
 
 | Package | Use case | Video route |
 |---|---|---|
@@ -10,6 +10,7 @@ Film-Kit ships as a single repository with four npm packages:
 | `@milenyumai/film-kit-multi` | Multi-agent parallel production | `veo31` or `kling-3.0` |
 | `@milenyumai/film-kit-hybrid` | Nano Banana stills + Kling video | fixed `kling-3.0` |
 | `@milenyumai/film-kit-hybrid-smart` | Nano Banana stills + smart Veo/Kling routing | dialogue-aware route |
+| `@milenyumai/film-kit-studio` | Scenario to rendered media | fal.ai Nano Banana + Kling render pipeline |
 
 ## Release Highlights
 
@@ -21,16 +22,32 @@ Film-Kit ships as a single repository with four npm packages:
 - Voice-design aware audio contract with project-level `voiceCast`, shot-level `Audio Plan`, and backward-compatible `Audio direction` blocks.
 - Aligned quality gates across Claude Code, Cursor, Copilot, and Antigravity.
 - Stronger Kling 3.0 and Kling multi-shot guidance, including practical route rules and hard caps.
+- OpenAI Codex App repo-scoped surfaces across packages:
+  - `.codex/config.toml` with full-auto local profile
+  - `.codex/agents/*.toml` custom agents that point back to Film-Kit roles
+  - `.agents/skills/*/SKILL.md` Codex skill mirror
+  - AGENTS.md project-root, trusted-project, and worktree bootstrap guidance
 
 ## Editors
 
 All packages generate professional project surfaces for:
 
+- OpenAI Codex App
 - Claude Code
 - Cursor
 - GitHub Copilot
 - Antigravity
 
+## OpenAI Codex App Support
+
+Film-Kit writes repo-scoped Codex files so the Codex desktop app can discover the project from the Git root:
+
+- `.codex/config.toml` uses `approval_policy = "never"`, `sandbox_mode = "danger-full-access"`, and `[agents] max_threads = 6`, `max_depth = 1`.
+- `.codex/agents/*.toml` defines minimal custom agents that read the canonical `.agent/agents/*.md` role files.
+- `.agents/skills/*/SKILL.md` mirrors the final `.agent/skills` runtime so Codex skill discovery sees package-specific overrides.
+- Studio adds a project-scoped fal.ai MCP entry at `.codex/config.toml` with `required = false`; missing `FAL_KEY` is reported during render rather than breaking init.
+- If Codex opens a worktree without dependencies or build output, follow `AGENTS.md`: run `npm install` and `npm run build` before package commands.
+
 ## Package Guide
 
 ### 1. `@milenyumai/film-kit`
@@ -97,7 +114,8 @@ Key contracts:
 
 - one file per shot
 - route is always `kling-3.0`
-- app.kling custom storyboard cap: `3`
+- app.kling custom storyboard cap: `4`
+- Kling prompt code blocks start with `[CHARACTER / SUBJECT CONSISTENCY]`
 - hybrid-specific spatial realism rules for layered blocking
 
 ### 4. `@milenyumai/film-kit-hybrid-smart`
@@ -120,7 +138,8 @@ Key contracts:
 
 - per-section route declaration
 - Veo/Kling grammar separation
-- app.kling custom storyboard cap: `3`
+- app.kling custom storyboard cap: `4`
+- Kling-routed no-dialogue prompt code blocks start with `[CHARACTER / SUBJECT CONSISTENCY]`
 - shared spatial realism gate
 
 ## Shared Quality System
@@ -196,7 +215,7 @@ Smart hybrid:
   "defaultAspectRatio": "16:9",
   "nanoBananaImageSize": "2K",
   "klingPreset": "ultra-realism",
-  "maxKlingCustomShots": 3
+  "maxKlingCustomShots": 4
 }
 ```
 
@@ -214,6 +233,7 @@ Package publishing happens from:
 - `packages/multi` for `@milenyumai/film-kit-multi`
 - `packages/hybrid` for `@milenyumai/film-kit-hybrid`
 - `packages/hybrid-smart` for `@milenyumai/film-kit-hybrid-smart`
+- `packages/studio` for `@milenyumai/film-kit-studio`
 
 ## License
 

package/build/lib/configure.js

@@ -36,7 +36,7 @@ async function collectFiles(dir, prefix = "") {
 /**
  * Copy content files from the package's content/ directory into the target project's .agent/ directory.
  */
-async function copyContentFiles(rootDir, overwrite, templateVars) {
+async function copyContentFiles(rootDir, overwrite, templateVars, targetRoot = ".agent", skillsOnly = false) {
     const contentDir = getContentDir();
     const contentExists = await exists(contentDir);
     if (!contentExists) {
@@ -46,7 +46,10 @@ async function copyContentFiles(rootDir, overwrite, templateVars) {
     const written = [];
     const skipped = [];
     for (const file of files) {
-        const targetRelative = `.agent/${file.relativePath}`;
+        if (skillsOnly && !file.relativePath.startsWith("skills/")) {
+            continue;
+        }
+        const targetRelative = `${targetRoot}/${file.relativePath}`;
         const targetAbsolute = join(rootDir, targetRelative);
         const targetExists = await exists(targetAbsolute);
         if (targetExists && !overwrite) {
@@ -136,10 +139,19 @@ export async function configureAgents(options = {}) {
             modelDisplayName: getModelDisplayName(resolved.model)
         })
         : { written: [], skipped: [] };
+    const codexSkillMirrorResult = resolved.copyContent && resolved.platforms.includes("codex")
+        ? await copyContentFiles(resolved.rootDir, resolved.overwrite, {
+            outputDir: resolved.outputDir,
+            scenarioHint: resolved.scenarioHint,
+            model: resolved.model,
+            klingPreset: resolved.klingPreset,
+            modelDisplayName: getModelDisplayName(resolved.model)
+        }, ".agents", true)
+        : { written: [], skipped: [] };
     // 2. Generate platform-specific config files
     const files = buildProjectFiles(resolved);
-    const written = [...contentResult.written];
-    const skipped = [...contentResult.skipped];
+    const written = [...contentResult.written, ...codexSkillMirrorResult.written];
+    const skipped = [...contentResult.skipped, ...codexSkillMirrorResult.skipped];
     for (const [relativePath, content] of Object.entries(files)) {
         const absolutePath = join(resolved.rootDir, relativePath);
         const fileExists = await exists(absolutePath);

package/build/lib/defaults.js

@@ -1,4 +1,4 @@
-const ALL_PLATFORMS = ["cursor", "claude", "copilot", "antigravity"];
+const ALL_PLATFORMS = ["cursor", "claude", "copilot", "antigravity", "codex"];
 const DEFAULT_MODEL = "veo31";
 const DEFAULT_KLING_PRESET = "ultra-realism";
 export function resolveOptions(input) {